IVideoWindow::put_Owner (Compact 2013)

  • Article

3/26/2014

This method sets an owning parent for the video window.

Syntax

HRESULT put_Owner(
  OAHWND Owner
);

Parameters

  • Owner
    [in] Handle of new owner window.

Return Value

Returns an HRESULT value.

Remarks

This method offers a way for applications to set the owner of the video window. This is often used when playing videos in compound documents. This method changes the parent of the renderer window and sets the WS_CHILD style for the video window.

To forward video window messages to the parent window, use the IVideoWindow::put_MessageDrain method, supplying the window handle of the parent window. This method does not post messages automatically.

After using this method to set the owner of a video window, you must reset the owner to NULL (by calling put_Owner(NULL)) before releasing the filter graph. Otherwise, messages will continue to be sent to this window and errors will likely occur when the application is terminated.

Requirements

Header

dshow.h

Library

Strmiids.lib

See Also

Reference

IVideoWindow Interface