3.4 Groups Role Details

Figure 18: Role of a peer and the host when sending and receiving Group messages

The role of a peer and the host when sending Group messages (section 2.2.4):

1. When any of the following messages are sent, the peer waits for a response from the host.

   • DN_REQ_CREATE_GROUP (section 2.2.4.1)

   • DN_REQ_ADD_PLAYER_TO_GROUP (section 2.2.4.3)

   • DN_REQ_DESTROY_GROUP (section 2.2.4.7)

     If the host does not respond in time, the protocol times out and the connection is terminated.

2. Otherwise, when the peer receives any of the following messages in response from the host, the peer processes the message.

   • DN_CREATE_GROUP (section 2.2.4.2)

   • DN_ADD_PLAYER_TO_GROUP (section 2.2.4.4)

   • DN_DESTROY_GROUP (section 2.2.4.8)

   If the message is invalid, the peer performs cleanup and the message is ignored. Otherwise, the message is consumed.

The role of a peer and the host when receiving Group messages:

• When any of the following messages is received from a peer in the session, it is processed by the host.

  • DN_REQ_CREATE_GROUP

  • DN_REQ_ADD_PLAYER_TO_GROUP

  • DN_REQ_DESTROY_GROUP

If the message is invalid, the host performs cleanup and the message is ignored. Otherwise, the host responds with one of the following messages back to the peer:

• DN_CREATE_GROUP

• DN_ADD_PLAYER_TO_GROUP

• DN_DESTROY_GROUP

Note When working with groups, be aware of considerations related to DirectX Diagnostic (DXDiag). The DXDiag tool (DxDiag.exe) implementation of this specification does not support groups.