2.2.5.1 DN_REQ_UPDATE_INFO
The DN_REQ_UPDATE_INFO message is sent from a peer/client to the host/server to update information about a specified peer/client in the game session.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
dwPacketType |
|||||||||||||||||||||||||||||||
|
dwPacketContext |
|||||||||||||||||||||||||||||||
|
dpnid |
|||||||||||||||||||||||||||||||
|
dwInfoFlags |
|||||||||||||||||||||||||||||||
|
dwNameOffset |
|||||||||||||||||||||||||||||||
|
dwNameSize |
|||||||||||||||||||||||||||||||
|
dwDataOffset |
|||||||||||||||||||||||||||||||
|
dwDataSize |
|||||||||||||||||||||||||||||||
|
data (variable) |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
name (variable) |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
dwPacketType (4 bytes): A 32-bit field that contains the packet type.
-
Value
Meaning
DN_MSG_INTERNAL_REQ_UPDATE_INFO
0x000000D6
Update info request from a peer/client to the host/server.
dwPacketContext (4 bytes): A 32-bit field that contains the context value passed in for this operation. The value MUST be passed in exactly with DN_UPDATE_INFO.
dpnid (4 bytes): A 32-bit field that contains the identifier for the peer/client to have update information. For more information, see section 2.2.7.
dwInfoFlags (4 bytes): A 32-bit field that contains the flags passed in specifying the data fields that are to be updated with this request.
-
Value
Meaning
DPNINFO_NAME
0x00000001
Indicates whether a name is included with this packet.
DPNINFO_DATA
0x00000002
Indicates whether data is included with this packet.
dwNameOffset (4 bytes): A 32-bit field that contains the offset from the end of dwPacketType of the name field for the dpnid. If dwNameOffset is 0, the packet does not include name data.
dwNameSize (4 bytes): A 32-bit field that contains the size, in bytes, of the data in the name field. If dwNameOffset is set to 0, dwNameSize SHOULD also be 0. If dwNameOffset is not 0, dwNameSize SHOULD also not be 0.
dwDataOffset (4 bytes): A 32-bit field that contains the offset from the end of dwPacketType of the data field. If dwDataOffset is 0, the packet does not include application data.
dwDataSize (4 bytes): A 32-bit field that contains the size, in bytes, of the data field. If dwDataOffset is set to 0, dwDataSize SHOULD also be 0. If dwDataOffset is not 0, dwDataSize SHOULD also not be 0.
data (variable): A variable-length field that contains a byte array that provides the application data. This field's position is determined by dwDataOffset and the size stated in dwDataSize.
name (variable): A variable-length field that contains a zero-terminated wide character array that specifies the player's name. This field's position is determined by dwNameOffset and the size stated in dwNameSize.