2.2.33 DPSP_MSG_IAMNAMESERVER

  • Article

The DPSP_MSG_IAMNAMESERVER packet is sent to inform participants of the identity of the name server (host).


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)

...

...

IDTo

IDHost

Flags

SPDataSize

SPData (variable)

...

DPSP_MSG_HEADER (28 bytes): The message header for this packet. The Command Value member of this field MUST be set to 53 (0x35).

IDTo (4 bytes): MUST be set to the identifier of the destination player.

IDHost (4 bytes): MUST be set to the system player ID of the new DirectPlay host.

Flags (4 bytes): MUST be set to the player flags that describe the system player of the new host.


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

SP

NS

PG

X

SP (1 bit): The player is the system player.

NS (1 bit): The player is the name server (host). MUST be combined with SP.

PG (1 bit): The player belongs to a group. This flag MUST be set for system players, for other players that have been added to a group using DPSP_MSG_ADDPLAYERTOGROUP (section 2.2.12), or for groups that have been added to a group using DPSP_MSG_ADDSHORTCUTTOGROUP (section 2.2.13).

X (29 bits): All bits that have this label SHOULD be set to zero when sent and MUST be ignored on receipt.

SPDataSize (4 bytes): MUST contain the length, in octets, of the SPData field.

SPData (variable): If SPDataSize is nonzero, MUST be set to the data that is used by the DirectPlay Service Provider.

If provided, the Windows Winsock DirectPlay Service Provider stores the following data in the SPData field.


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

Stream Socket Address (16 bytes)

...

...

Datagram Socket Address (16 bytes)

...

...

Stream Socket Address (16 bytes): A SOCKADDR_IN structure that contains the addressing information to be used when contacting this player over TCP. The Address field of this SOCKADDR_IN must be set to 0.0.0.0.

Datagram Socket Address (16 bytes): A SOCKADDR_IN structure that contains the addressing information to be used when contacting this player over UDP. The Address field of this SOCKADDR_IN must be set to 0.0.0.0.