2.2.29 DPSP_MSG_ENUMSESSIONS

  • Article

The DPSP_MSG_ENUMSESSIONS packet is sent by the client to request an enumeration of DirectPlay 4 game sessions.


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

DPSP_MSG_HEADER (28 bytes)

...

...

ApplicationGuid (16 bytes)

...

...

PasswordOffset

Flags

Password (variable)

...

DPSP_MSG_HEADER (28 bytes): Message header for this packet. The Command Value member of this field MUST be set to 2 (0x02).

ApplicationGuid (16 bytes): MUST be set to the application identifier for the game.

PasswordOffset (4 bytes): MUST be set to the offset, in octets, of the password from the beginning of the message.

Flags (4 bytes): MUST be set to one or more of the specified enumeration game session flags passed in by the game.


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

AV

AL

X

PR

Y

AV (1 bit): Enumerate game sessions that can be joined.

AL (1 bit): Enumerate all game sessions, even if they cannot be joined.

X (4 bits): Not used. SHOULD be set to zero when sent and MUST be ignored on receipt.

PR (1 bit): Enumerate all game sessions, even if they require a password.

Y (25 bits): Not used. SHOULD be set to zero when sent and MUST be ignored on receipt.

Password (variable): MUST be set to a null-terminated Unicode string that contains the password. This value is present only if the PasswordOffset field is nonzero.