IDirectPlayVoiceClient::GetSoundDeviceConfig Method

Retrieves the sound device configuration of the session.

Syntax

HRESULT GetSoundDeviceConfig(      
    PDVSOUNDDEVICECONFIG pSoundDeviceConfig,
    PDWORD pdwSize
);

Parameters

pSoundDeviceConfig

[out] Pointer to a DVSOUNDDEVICECONFIG structure that is filled with the configuration of the sound device.

pdwSize

[in, out] Pointer to a DWORD that specifies the size of the buffer in pSoundDeviceConfig parameter. If the buffer is too small, the method returns DVERR_BUFFERTOOSMALL and this parameter contains the size of the required buffer.

Return Value

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

DVERR_INVALIDPARAM	One or more of the parameters passed to the method are invalid.
DVERR_INVALIDPOINTER	The pointer specified is invalid.
DVERR_NOTCONNECTED	The Microsoft® DirectPlay® Voice object is not connected.
DVERR_NOTINITIALIZED	The IDirectPlayVoiceClient::Initialize or IDirectPlayVoiceServer::Initialize method must be called before calling this method.
DVERR_SESSIONLOST	The transport has lost the connection to the session.

Remarks

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