IVideoWindow::NotifyOwnerMessage method (control.h)
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The NotifyOwnerMessage
method forwards a message to the video window.
Syntax
HRESULT NotifyOwnerMessage(
[in] OAHWND hwnd,
[in] long uMsg,
[in] LONG_PTR wParam,
[in] LONG_PTR lParam
);
Parameters
[in] hwnd
A handle to the window, as an OAHWND value.
[in] uMsg
Specifies the message.
[in] wParam
Message parameter.
[in] lParam
Message parameter.
Return value
Possible return values include the following:
Return code | Description |
---|---|
|
Success. |
|
The video renderer filter is not connected. |
Remarks
The Filter Graph Manager calls this method to pass various messages to the renderer, including the following:
- WM_ACTIVATEAPP
- WM_DEVMODECHANGE
- WM_DISPLAYCHANGE
- WM_PALETTECHANGED
- WM_PALETTEISCHANGING
- WM_QUERYNEWPALETTE
- WM_SYSCOLORCHANGE
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 2000 Professional [desktop apps only] |
Minimum supported server | Windows 2000 Server [desktop apps only] |
Target Platform | Windows |
Header | control.h (include Dshow.h) |
Library | Strmiids.lib |