IOverlayNotify2 Interface

The IOverlayNotify2 interface derives from the IOverlayNotify interface. IOverlayNotify2 gives asynchronous notifications of changes to the rendering window, identifying changes to the exposed window area. The advise link optionally supports this for the purpose of accepting IOverlayNotify2::OnDisplayChange notification.

To get notifications that the exposed window area has changed, decoders that do their own drawing should implement an IOverlayNotify2 interface.

The video renderer is the only filter that calls the method on this interface. This is done automatically by the default video renderer.

Methods in Vtable Order

IUnknown methods Description
QueryInterface Retrieves pointers to supported interfaces.
AddRef Increments the reference count.
Release Decrements the reference count.

IOverlayNotify methods Description
OnPaletteChange Provides notification that the palette of the window has changed.
OnClipChange Provides notification that the visible region of the window has changed.
OnColorKeyChange Provides notification that the chroma key has changed.

OnPositionChange Provides notification that the position has changed.

IOverlayNotify2 method Description
OnDisplayChange Provides notification that the exposed window area has changed.

IUnknown methods	Description
QueryInterface	Retrieves pointers to supported interfaces.
AddRef	Increments the reference count.
Release	Decrements the reference count.
IOverlayNotify methods	Description
OnPaletteChange	Provides notification that the palette of the window has changed.
OnClipChange	Provides notification that the visible region of the window has changed.
OnColorKeyChange	Provides notification that the chroma key has changed.
OnPositionChange	Provides notification that the position has changed.
IOverlayNotify2 method	Description
OnDisplayChange	Provides notification that the exposed window area has changed.

IOverlayNotify2::OnDisplayChange

IOverlayNotify2 Interface

Provides notification that the exposed window area has changed.

Syntax

HRESULT OnDisplayChange(
    HMONITOR hMonitor
);

Parameters

hMonitor
[in] Handle to the monitor used for displaying the overlay.

Return Value

Returns an HRESULT value that depends on the implementation. HRESULT can be one of the following standard constants, or other values not listed.

E_FAIL Failure.
E_POINTER Null pointer argument.
E_INVALIDARG Invalid argument.
E_NOTIMPL Method isn't supported.
S_OK or NOERROR Success.

E_FAIL	Failure.
E_POINTER	Null pointer argument.
E_INVALIDARG	Invalid argument.
E_NOTIMPL	Method isn't supported.
S_OK or NOERROR	Success.