2.2.2.8 Client Capability Confirmation Message
This message is used by the Connection Subprotocol (section 1.3.2), and for host migration of the Peer Voice Session Subprotocol (section 1.3.3). For the connection subprotocol, it is sent by the voice client to complete capability negotiation. For host migration of the Peer Voice Session Subprotocol, it is used by voice clients to communicate capabilities to the new host when a host migration is complete. This message is sent as an ordered, guaranteed message using the DirectPlay protocol voice message type.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Header |
PlayerFlags |
||||||||||||||||||||||||||||||
|
... |
HostOrderID |
||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
Header (1 byte): The common message header (as specified in section 2.2.1). The MessageType field MUST be set to DVMSGID_SETTINGSCONFIRM (0x58).
PlayerFlags (4 bytes): A 32-bit unsigned integer. This represents a set of bit flags representing client audio capabilities. This field MUST be composed of the bitwise OR of zero or more of the following values.
-
Value
Meaning
DVPLAYERCAPS_HALFDUPLEX
0x00000001
The voice client cannot record audio and will therefore not be transmitting any encoded audio data.
HostOrderID (4 bytes): A 32-bit unsigned integer representing the host order ID of the voice client. When host migration is enabled as described in section 1.3.3.1, and the Client Capability Confirmation Message is used during host migration, the HostOrderID field MUST be set to the Current Host Order ID of the voice client. Otherwise, HostOrderID MUST be set to 0xFFFFFFFF. For more information about the Current Host Order ID, see sections 3.1.1 and 3.1.3.