2.2.5.2 DN_UPDATE_INFO

Response from the host/server to a DN_REQ_UPDATE_INFO packet. This packet is sent to all players with the updated information.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

dwPacketType

dwPacketContext

dpnid

dwVersion

dwVersionNotUsed

dwInfoFlags

dwNameOffset

dwNameSize

dwDataOffset

dwDataSize

dpnidRequesting

data (variable)

...

name (variable)

...

dwPacketType (4 bytes): A 32-bit field that contains the packet type.

Value

Meaning

DN_MSG_INTERNAL_UPDATE_INFO

0x000000DB

Update info response from a host/server to a peer/client.

dwPacketContext (4 bytes): A 32-bit field that contains the context value passed in for this operation. This value MUST be passed back exactly as it was passed in with DN_REQ_UPDATE_INFO (section 2.2.5.1).

dpnid (4 bytes): A 32-bit field that contains the identifier for the peer/client that was updated. For more information, see section 2.2.7.

dwVersion (4 bytes): A 32-bit integer that specifies the current name table version.

dwVersionNotUsed (4 bytes): Not used.

dwInfoFlags (4 bytes): A 32-bit field that contains the passed flags that were updated.

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.

dpnidRequesting (4 bytes): A 32-bit field that contains the identifier for the player that requested that this information be updated. For more information, see section 2.2.7.

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.