IRTCClient::put_PreferredAudioDevice

  • Article

The put_PreferredAudioDevice property sets the preferred audio device for audio capturing or rendering. This method sets the audio device retrieved in IRTCClient::get_PreferredAudioDevice.

HRESULT put_PreferredAudioDevice(RTC_AUDIO_DEVICEenDevice,
BSTRbstrDeviceName);

Parameters

  • enDevice
    [in] Name of the audio device that is set.
  • bstrDeviceName
    [in] The RTC_AUDIO_DEVICE enumeration specifies which audio media device to set.

Return Values

RTC methods may return an RTC_E_ constant.

Value Meaning
E_INVALIDARG No such audio device.
RTC_E_CLIENT_NOT_INITIALIZED The client has not been initialized.

Remarks

The value that this method sets will persist for each user after the application is shut down.

Requirements

Client: Requires Windows XP.
Server: Requires Windows Server 2003.
Redistributable: Requires Rtcdll.dll on Windows 2000, and Windows Me/98.
Header: Declared in Rtccore.h.
Library: Included as a resource in Rtcdll.dll.
GUID: IID_IRTCClient is defined as 07829e45-9a34-408e-a011-bddf13487cd1.

See Also

IRTCClient, RTC_AUDIO_DEVICE, IRTCClient::get_PreferredAudioDevice, IRTCClient::put_PreferredVideoDevice