CBaseControlWindow::put_Owner

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Sets the video window's parent window; the parent window then forwards certain messages to the video window.

Syntax

HRESULT put_Owner(
  OAHWND Owner
);

Parameters

• Owner
  Handle to the parent window.

Return Value

Returns NOERROR.

Remarks

Internally, this method calls the Win32 SetParent function to set the new owner and sets the parent window's style to WS_CHILD. The parent window will then forward certain sets of messages (in particular, mouse and keyboard messages) to the video window.

After you set the video window's owner, you must set the owner to NULL and the owner's window style to WS_OVERLAPPED and WS_CLIPCHILDREN before releasing the filter graph.

When you set the owner to NULL, this method turns off the parent window's WS_CHILD bit.

If you do not set the owner to NULL, the parent window will continue to pass messages to the video window and errors will likely occur when the application closes.

Requirements