2.2.4.1 DN_REQ_CREATE_GROUP
The DN_REQ_CREATE_GROUP packet informs the host that a peer is requesting that a new group be created for the game session.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
dwPacketType |
|||||||||||||||||||||||||||||||
|
dwPacketContext |
|||||||||||||||||||||||||||||||
|
dwGroupFlags |
|||||||||||||||||||||||||||||||
|
dwInfoFlags |
|||||||||||||||||||||||||||||||
|
dwNameOffset |
|||||||||||||||||||||||||||||||
|
dwNameSize |
|||||||||||||||||||||||||||||||
|
dwDataOffset |
|||||||||||||||||||||||||||||||
|
dwDateSize |
|||||||||||||||||||||||||||||||
|
data (variable) |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
|
name (variable) |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
dwPacketType (4 bytes): A 32-bit field that contains the packet type.
-
Value
Meaning
DN_MSG_INTERNAL_REQ_CREATE_GROUP
0x000000D2
Informs the host that a peer is requesting that a new group be created in the game session.
dwPacketContext (4 bytes): A 32-bit field that contains the system identifier for this action. DN_CREATE_GROUP (see section 2.2.4.2) SHOULD respond to this message in the identical manner in which it was passed.
dwGroupFlags (4 bytes): A 32-bit field that contains the flags passed in on creation of a group, indicating certain behavior.
-
Value
Meaning
DPNGROUP_AUTODESTRUCT
0x00000001
Informs the host that the group SHOULD be deleted once all players have been removed.
dwInfoFlags (4 bytes): A 32-bit field that contains the flags passed in specifying the data that is 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 group. 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.
dwDateSize (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 the byte array that specifies 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 the zero-terminated wide character array that provides the group name. This field's position is determined by dwNameOffset and the size stated in dwNameSize.