Microsoft DirectX 9.0

IDirectPlayVoiceClient::SetClientConfig Method

Sets the client configuration.


HRESULT SetClientConfig(      

    PDVCLIENTCONFIG pClientConfig );


[in] Pointer to a DVCLIENTCONFIG structure that contains the configuration description to set.

Return Value

Returns DV_OK if successful, or one of the following error values.

DVERR_INVALIDFLAGSThe flags passed to this method are invalid.
DVERR_INVALIDPARAMOne or more of the parameters passed to the method are invalid.
DVERR_INVALIDPOINTERThe pointer specified is invalid.
DVERR_NOTCONNECTEDThe Microsoft?DirectPlay?Voice object is not connected.
DVERR_NOTINITIALIZEDThe IDirectPlayVoiceClient::Initialize or IDirectPlayVoiceServer::Initialize method must be called before calling this method.
DVERR_SESSIONLOSTThe transport has lost the connection to the session.


You can call this method only after a connection is successfully established with a DirectPlay Voice session.

Calling this method sets all the parameters in the DVCLIENTCONFIG structure. Therefore, to leave a setting unmodified, you must retrieve the current configuration with IDirectPlayVoiceClient::GetClientConfig. Then modify the parameters to change and call IDirectPlayVoiceClient::SetClientConfig.

If the session is running in half duplex mode, the members of the DVCLIENTCONFIG structure related to recording are ignored.

© 2002 Microsoft Corporation. All rights reserved.