Difference between revisions of "NWMUDS:Bind"
Jump to navigation
Jump to search
| (11 intermediate revisions by the same user not shown) | |||
| Line 9: | Line 9: | ||
|- | |- | ||
| 1 | | 1 | ||
| − | | | + | | BindNodeID |
|- | |- | ||
| − | | 2-4 | + | | 2 |
| − | | | + | | u32 recv_buffer_size. Official user-processes require this to be >=0x646. This is the ''exact'' size of the buffer allocated under sharedmem used for storing the received data which can then be loaded via [[NWMUDS:PullPacket]](this includes header data). NWM-module itself ''only'' requires this size to be >=0x5F4(this is only checked after allocating the buffer). |
| + | |- | ||
| + | | 3 | ||
| + | | u8 data_channel | ||
| + | |- | ||
| + | | 4 | ||
| + | | u16 NetworkNodeID probably. Likely for controlling which device this BindNodeID can communicate with, or all of them when the broadcast alias is used. | ||
|} | |} | ||
| Line 31: | Line 37: | ||
|- | |- | ||
| 3 | | 3 | ||
| − | | Output handle. | + | | Output event handle. This is signaled every time data becomes available via [[NWMUDS:PullPacket]]. |
|} | |} | ||
| + | |||
| + | =Data Channel= | ||
| + | This is an arbitrary value to use for data-frame filtering. This bind will only receive data frames which contain a matching data_channel value. The input data_channel value for this command must be non-zero, otherwise error 0xE10113EA is returned. | ||
=Description= | =Description= | ||
| − | This initializes | + | This initializes a [[NWM_Services|BindNodeID]] for use on this device, etc. This can be done multiple times for initializing different BindNodeIDs. |
Latest revision as of 16:56, 14 April 2016
Request[edit]
| Index Word | Description |
|---|---|
| 0 | Header code [0x00120100] |
| 1 | BindNodeID |
| 2 | u32 recv_buffer_size. Official user-processes require this to be >=0x646. This is the exact size of the buffer allocated under sharedmem used for storing the received data which can then be loaded via NWMUDS:PullPacket(this includes header data). NWM-module itself only requires this size to be >=0x5F4(this is only checked after allocating the buffer). |
| 3 | u8 data_channel |
| 4 | u16 NetworkNodeID probably. Likely for controlling which device this BindNodeID can communicate with, or all of them when the broadcast alias is used. |
Response[edit]
| Index Word | Description |
|---|---|
| 0 | Header code |
| 1 | Result code |
| 2 | Value 0x0, handle transfer translate-header. |
| 3 | Output event handle. This is signaled every time data becomes available via NWMUDS:PullPacket. |
Data Channel[edit]
This is an arbitrary value to use for data-frame filtering. This bind will only receive data frames which contain a matching data_channel value. The input data_channel value for this command must be non-zero, otherwise error 0xE10113EA is returned.
Description[edit]
This initializes a BindNodeID for use on this device, etc. This can be done multiple times for initializing different BindNodeIDs.