IRTCClient2::InvokeTuningWizardEx
The InvokeTuningWizardEx method invokes the tuning wizard, and permits the user to specify whether audio and/or video tuning is allowed. This method is synchronous and will return once the tuning wizard is complete. This method will fail if called during an active session.
HRESULT InvokeTuningWizardEx(OAHWNDhwndParent,
VARIANT_BOOLfAllowAudio,
VARIANT_BOOLfAllowVideo);
Parameters
- hwndParent
[in] Handle to the content parent window. - fAllowAudio
[in] Variant Boolean value indicating whether to allow audio tuning. - fAllowVideo
[in] Variant Boolean value indicating whether to allow video tuning.
Return Values
RTC methods may return an RTC_E_ constant.
Value | Meaning |
---|---|
RTC_E_CLIENT_NOT_INITIALIZED | The client object has not been initialized. |
RTC_E_MEDIA_DISABLED | The media manager has been disabled. |
RTC_E_MEDIA_CONTROLLER_STATE | The media is already active, or the tuning wizard is already active. |
E_INVALIDARG | The hwndParent parameter is NULL or is not a valid window paramater. This error is also returned if both the fAllowAudio and fAllowVideo parameters are set to VARIANT_FALSE. |
Remarks
This method extends the functionality provided by IRTCClient::InvokeTuningWizard.
Requirements
Redistributable: Requires Rtcdll.dll on Windows 2000, Windows XP, and Windows Server 2003.
Header: Declared in Rtccore.h.
Library: Included as a resource in Rtcdll.dll.
GUID: IID_IRTCClient2 is defined as 0C91D71D-1064-42da-BFA5-572BEB8EEA84.