NWMUDS:StartScan: Difference between revisions

From 3dbrew
Jump to navigation Jump to search
No edit summary
Steveice10 (talk | contribs)
 
(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

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

Index Word Description
0 Header code
1 Result code

Description

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.