Difference between revisions of "NWMUDS:StartScan"

From 3dbrew
Jump to navigation Jump to search
 
(6 intermediate revisions by one other user not shown)
Line 12: Line 12:
 
|-
 
|-
 
| 2-14
 
| 2-14
| 0x34-byte input structure.
+
| Input [[NWM_Services|ScanInputStruct]].
 
|-
 
|-
 
| 15
 
| 15
Line 24: Line 24:
 
|-
 
|-
 
| 18
 
| 18
| Input handle
+
| Input event handle
 
|-
 
|-
 
| 19
 
| 19
Line 30: Line 30:
 
|-
 
|-
 
| 20
 
| 20
| Output buffer ptr
+
| Output [[NWM_Services|BeaconDataReply]] buffer ptr
 
|}
 
|}
  
Line 46: Line 46:
 
|}
 
|}
  
=Input structure=
+
=Description=
{| class="wikitable" border="1"
+
This returns beacon data for all UDS wifi beacons received by this system, with the specified wlancommID+ID8. See also the scaninput struct.
|-
 
!  Index Word
 
!  Description
 
|-
 
| 0
 
| ?
 
|-
 
| 1
 
| ?
 
|-
 
| 2-3
 
| MAC address? The 6-bytes located here are normally all 0xFF.
 
|-
 
| 4-12
 
| Unknown, usually zero / uninitialized?
 
|}
 
  
=Description=
+
Official user processes create a new event handle which is then passed to this command. However, those user processes don't save that handle ''anywhere'' afterwards.
The input maxsize is written to outbuf+0. The total amount of data written to the output starting at offset 0x0, is written to outbuf+4. Outbuf+8 is zero when the buffer contains no actual received data, 1 otherwise. Therefore, when the output contains no actual received data the size value at outbuf+4 is set to 0xC.
 
  
The following is the structure of the data at outbuf+0xC. The data starting at +0x1C is the data from the entire raw beacon data, starting at the 802.11 management frame header. It's unknown what exactly the data prior to that is.
+
This command can ''only'' be used when not connected to a network.

Latest revision as of 08:38, 23 July 2023

Request[edit]

Index Word Description
0 Header code [0x000F0404]
1 Output buffer max size
2-14 Input ScanInputStruct.
15 wlancommID
16 This is the ID also located at offset 0xE in the CTR-generation structure.
17 Value 0x0
18 Input event handle
19 (Size<<4) | 12
20 Output BeaconDataReply buffer ptr

Response[edit]

Index Word Description
0 Header code
1 Result code

Description[edit]

This returns beacon data for all UDS wifi beacons received by this system, with the specified wlancommID+ID8. See also the scaninput struct.

Official user processes create a new event handle which is then passed to this command. However, those user processes don't save that handle anywhere afterwards.

This command can only be used when not connected to a network.