CBaseControlWindow::NotifyOwnerMessage
Microsoft DirectShow 9.0 |
CBaseControlWindow::NotifyOwnerMessage
The NotifyOwnerMessage method passes along specific messages to the video window.
Syntax
HRESULT NotifyOwnerMessage( long hwnd, long uMsg, LONG_PTR wParam, LONG_PTR lParam );
Parameters
hwnd
Handle to the video window.
uMsg
Message details.
wParam
First message parameter.
lParam
Second message parameter.
Return Value
Returns NO_ERROR.
Remarks
When the video window is a child of another window, it does not receive certain top-level window messages. These messages can be valuable to a renderer, because they could affect its behavior. NotifyOwnerMessage passes any of the following messages to the video window.
- WM_ACTIVATEAPP
- WM_DEVMODECHANGE
- WM_DISPLAYCHANGE
- WM_PALETTECHANGED
- WM_PALETTEISCHANGING
- WM_QUERYNEWPALETTE
- WM_SYSCOLORCHANGE
You can request that the IVideoWindow plug-in distributor (PID) make a window become a child of another window. When this occurs, the PID will look for certain messages that might be sent to the owning window. The PID will then forward those messages to the owned window. The default processing for the messages is to send them to the owned window procedure synchronously by calling the Win32 SendMessage function.
Requirements
** Header:** Declared in Ctlutil.h; include Streams.h.
** Library:** Use Strmbase.lib (retail builds) or Strmbasd.lib (debug builds).
See Also