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