Changes

182 bytes added ,  19:56, 6 February 2021
no edit summary
Line 585: Line 585:     
== CreateNetworkService ==
 
== CreateNetworkService ==
Takes an input u32, an u64 pid_reserved, a PID, returns an output [[#INetworkService]].
+
Takes a PID-descriptor, a reserved input u64 and an input u32. Returns an output [[#INetworkService]].
    
The input u32 must be value 0x1.
 
The input u32 must be value 0x1.
    
== CreateNetworkServiceMonitor ==
 
== CreateNetworkServiceMonitor ==
Takes an input u64 pid_reserved, a PID, returns an output [[#INetworkServiceMonitor]].
+
Takes a PID-descriptor and a reserved input u64. Returns an output [[#INetworkServiceMonitor]].
    
== INetworkService ==
 
== INetworkService ==
Line 611: Line 611:  
| [9.0.0-9.0.1] 288 || [[#GetGroupInfo]]
 
| [9.0.0-9.0.1] 288 || [[#GetGroupInfo]]
 
|-
 
|-
| [9.0.0-9.0.1] 296 || [[#Join]]
+
| [9.0.0-9.0.1] 296 || [[#GetGroupInfo2]]
 
|-
 
|-
 
| [9.0.0-9.0.1] 304 || [[#GetGroupOwner]]
 
| [9.0.0-9.0.1] 304 || [[#GetGroupOwner]]
Line 617: Line 617:  
| [9.0.0-9.0.1] 312 || [[#GetIpConfig]]
 
| [9.0.0-9.0.1] 312 || [[#GetIpConfig]]
 
|-
 
|-
| [9.0.0-9.0.1] 320 || [[#Leave]]
+
| [9.0.0-9.0.1] 320 || [[#GetLinkLevel]]
 
|-
 
|-
 
| 512 || [[#Scan]]
 
| 512 || [[#Scan]]
Line 633: Line 633:  
| 1552 || [[#AddAcceptableGroupId]]
 
| 1552 || [[#AddAcceptableGroupId]]
 
|-
 
|-
| 1560 || [9.1.0+] [[#RemoveAcceptableGroupId]]
+
| 1560 || [9.1.0+] [[#ClearAcceptableGroupId]]
 
|}
 
|}
   Line 644: Line 644:     
=== Scan ===
 
=== Scan ===
Takes a type-0x19 input buffer containing a [[#GroupInfo]], a type-0x22 output buffer containing an array of [[#ScanResult]], returns an output s32 total_out.
+
Takes a type-0x19 input buffer containing a [[#GroupInfo]] and a type-0x22 output buffer containing an array of [[#ScanResult]]. Returns an output s32 '''TotalOut'''.
    
=== CreateGroup ===
 
=== CreateGroup ===
Takes a type-0x31 input buffer containing a [[#GroupInfo]], no output.
+
Takes a type-0x31 input buffer containing a [[#GroupInfo]]. No output.
    
[[Mario Kart Live: Home Circuit|mklive]] uses the following string with this: "Failed to create a group: %08X".
 
[[Mario Kart Live: Home Circuit|mklive]] uses the following string with this: "Failed to create a group: %08X".
Line 659: Line 659:     
=== SetAdvertiseData ===
 
=== SetAdvertiseData ===
Takes a type-0x21 input buffer, no output.
+
Takes a type-0x21 input buffer. No output.
    
The buffer size must be <=0x80. The [[#GetRole|role]] must be <=1.
 
The buffer size must be <=0x80. The [[#GetRole|role]] must be <=1.
Line 666: Line 666:     
=== SendToOtherGroup ===
 
=== SendToOtherGroup ===
Takes an input [[#MacAddress_2|MacAddress]], a [[#GroupId]], a s16 frequency, a s16 channel, an u32 flags, a type-0x21 input buffer, no output.
+
Takes an input [[#MacAddress_2|MacAddress]], a [[#GroupId]], a s16 '''Frequency''', a s16 '''Channel''', an u32 '''MessageFlag''' and a type-0x21 input buffer. No output.
    
The buffer size must be <=0x400.
 
The buffer size must be <=0x400.
Line 685: Line 685:     
=== RecvFromOtherGroup ===
 
=== RecvFromOtherGroup ===
Takes an input u32 flags, a type-0x22 output buffer, returns a [[#MacAddress_2|MacAddress]], an u16, a s16, an u32 out_size, a s32.
+
Takes an input u32 '''MessageFlag''' and a type-0x22 output buffer. Returns a [[#MacAddress_2|MacAddress]], an u16 '''Frequency''', a s16 '''Channel''', an u32 '''OutSize''' and a s32.
   −
The out_size is the original size used for copying to the output buffer, before it's clamped to the output-buffer size.
+
The OutSize is the original size used for copying to the output buffer, before it's clamped to the output-buffer size.
   −
Only bit0 is used from flags: clear = block until data is available, set = return error when data is not available.
+
Only bit0 is used from MessageFlag: clear = block until data is available, set = return error when data is not available.
    
When data is not available, the error from [[#GetNetworkInterfaceLastError]] will be returned if it's set.
 
When data is not available, the error from [[#GetNetworkInterfaceLastError]] will be returned if it's set.
Line 698: Line 698:     
=== AddAcceptableGroupId ===
 
=== AddAcceptableGroupId ===
Takes an input [[#GroupId]], no output.
+
Takes an input [[#GroupId]]. No output.
   −
=== RemoveAcceptableGroupId ===
+
=== ClearAcceptableGroupId ===
 
No input/output.
 
No input/output.
   Line 726: Line 726:  
| 288 || [[#GetGroupInfo]]
 
| 288 || [[#GetGroupInfo]]
 
|-
 
|-
| 296 || [[#Join]]
+
| 296 || [[#GetGroupInfo2]]
 
|-
 
|-
 
| 304 || [[#GetGroupOwner]]
 
| 304 || [[#GetGroupOwner]]
Line 732: Line 732:  
| 312 || [[#GetIpConfig]]
 
| 312 || [[#GetIpConfig]]
 
|-
 
|-
| 320 || [[#Leave]]
+
| 320 || [[#GetLinkLevel]]
 
|-
 
|-
 
| 328 || [[#AttachJoinEvent]]
 
| 328 || [[#AttachJoinEvent]]
Line 745: Line 745:     
=== AttachNetworkInterfaceStateChangeEvent ===
 
=== AttachNetworkInterfaceStateChangeEvent ===
No input, returns an output Event handle with EventClearMode=0.
+
No input. Returns an output Event handle with EventClearMode=0.
    
=== GetNetworkInterfaceLastError ===
 
=== GetNetworkInterfaceLastError ===
Line 751: Line 751:     
=== GetRole ===
 
=== GetRole ===
No input, returns an output u8.
+
No input. Returns an output u8.
    
=== GetAdvertiseData ===
 
=== GetAdvertiseData ===
Takes a type-0x22 output buffer, returns 2 output u16s.
+
Takes a type-0x22 output buffer. Returns two output u16s.
    
Validates that the [[#GetRole|role]] is value 2, then copies data from state into the output buffer. The first output u16 is the size used for the memcpy, the second u16 is the original size from state.
 
Validates that the [[#GetRole|role]] is value 2, then copies data from state into the output buffer. The first output u16 is the size used for the memcpy, the second u16 is the original size from state.
    
=== GetAdvertiseData2 ===
 
=== GetAdvertiseData2 ===
Takes a type-0x22 output buffer, returns 2 output u16s.
+
Takes a type-0x22 output buffer. Returns two output u16s.
    
This is identical to [[#GetAdvertiseData]] except this doesn't run the role validation.
 
This is identical to [[#GetAdvertiseData]] except this doesn't run the role validation.
Line 768: Line 768:  
Validates that the [[#GetRole|role]] is non-zero, then copies the struct from state into the output buffer.
 
Validates that the [[#GetRole|role]] is non-zero, then copies the struct from state into the output buffer.
   −
=== Join ===
+
=== GetGroupInfo2 ===
 
Takes a type-0x32 output buffer containing a [[#GroupInfo]] and a type-0x31 input buffer containing a [[#GroupInfo]].
 
Takes a type-0x32 output buffer containing a [[#GroupInfo]] and a type-0x31 input buffer containing a [[#GroupInfo]].
   Line 774: Line 774:     
=== GetGroupOwner ===
 
=== GetGroupOwner ===
No input, returns an output 0x80-bytes [[#NodeInfo_2|NodeInfo]].
+
No input. Returns an output [[#NodeInfo_2|NodeInfo]].
    
Validates that the [[#GetRole|role]] is non-zero, then copies the data from state to output.
 
Validates that the [[#GetRole|role]] is non-zero, then copies the data from state to output.
Line 785: Line 785:  
+0x20 is the <code>struct sockaddr</code> IP address, +0x40 is the <code>struct sockaddr</code> subnet-mask, +0x60 is the <code>struct sockaddr</code> gateway(?). The address for the last one is set to localhost.
 
+0x20 is the <code>struct sockaddr</code> IP address, +0x40 is the <code>struct sockaddr</code> subnet-mask, +0x60 is the <code>struct sockaddr</code> gateway(?). The address for the last one is set to localhost.
   −
=== Leave ===
+
=== GetLinkLevel ===
No input, returns an output u32.
+
No input. Returns an output u32.
    
=== AttachJoinEvent ===
 
=== AttachJoinEvent ===
No input, returns an output Event handle with EventClearMode=0.
+
No input. Returns an output Event handle with EventClearMode=0.
    
=== GetMembers ===
 
=== GetMembers ===
Takes a type-0x22 output buffer containing an array of [[#NodeInfo_2|NodeInfo]], returns an output s32 total_out.
+
Takes a type-0x22 output buffer containing an array of [[#NodeInfo_2|NodeInfo]]. Returns an output s32 '''TotalOut'''.
    
Validates that the [[#GetRole|role]] is value 1. Then any entries from state which are available are copied into the output array buffer, if there's space available. A maximum of 8 entries can be returned.
 
Validates that the [[#GetRole|role]] is value 1. Then any entries from state which are available are copied into the output array buffer, if there's space available. A maximum of 8 entries can be returned.
Line 811: Line 811:     
== CreateMonitorService ==
 
== CreateMonitorService ==
Takes a PID, a total of 0x10-bytes of input, and returns an [[#IMonitorService]].
+
Takes a PID-descriptor, a reserved input u64 and an input u64. Returns an [[#IMonitorService]].
    
== IMonitorService ==
 
== IMonitorService ==
Line 824: Line 824:  
| 288 || [[#GetGroupInfo]]
 
| 288 || [[#GetGroupInfo]]
 
|-
 
|-
| 320 || [[#Leave]]
+
| 320 || [[#GetLinkLevel]]
 
|}
 
|}