IRTCClient::get_IVideoWindow

  • Article

The get_IVideoWindow property gets the IVideoWindow interface associated with the specified video window.

HRESULT get_IVideoWindow(RTC_VIDEO_DEVICEenDevice,
IVideoWindow**ppIVideoWindow);

Parameters

  • enDevice
    [in] An RTC_VIDEO_DEVICE enumeration that specifies the video window for the IVideoWindow interface.
  • ppIVideoWindow
    [out] Pointer to the IVideoWindow interface. This call adds a reference to the interface, which the caller is responsible for releasing.

Return Values

RTC methods may return an RTC_E_ constant.

Value Meaning
RTC_E_CLIENT_NOT_INITIALIZED The client has not been initialized.

Remarks

After using this method, the application must set the owner of the window to NULL before releasing the filter graph. The application sets the owner to NULL by calling the put_Owner method on the IVideoWindow object. If the owner is not set to NULL, messages will continue to be sent to this window and errors will likely occur when the application is terminated.

Requirements

Client: Requires Windows XP.
Server: Requires Windows Server 2003.
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_VIDEO_DEVICE, Show Video