IVPNotify Interface

IVPNotify is a private communication mechanism between the Overlay Mixer filter and a VPE decoder filter. This interface derives from IVPBaseNotify. See also IVPBaseConfig and IVPConfig.

The Overlay Mixer filter implements this interface so you won't need to implement it unless you need to alter the default behavior.

This interface is not intended for use by applications.

Methods in Vtable Order

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

IVPBaseNotify methods Description
RenegotiateVPParameters Initializes the connection to the decoder.

IVPNotify methods Description
SetDeinterlaceMode Sets the deinterlacing mode (such as bob or weave).
GetDeinterlaceMode Retrieves the deinterlacing mode (such as bob or weave).
SetColorControls Sets the color control settings associated with the specified overlay or primary surface.
GetColorControls Retrieves the current color control settings associated with the specified overlay or primary surface.

IUnknown methods	Description
QueryInterface	Retrieves pointers to supported interfaces.
AddRef	Increments the reference count.
Release	Decrements the reference count.
IVPBaseNotify methods	Description
RenegotiateVPParameters	Initializes the connection to the decoder.
IVPNotify methods	Description
SetDeinterlaceMode	Sets the deinterlacing mode (such as bob or weave).
GetDeinterlaceMode	Retrieves the deinterlacing mode (such as bob or weave).
SetColorControls	Sets the color control settings associated with the specified overlay or primary surface.
GetColorControls	Retrieves the current color control settings associated with the specified overlay or primary surface.

IVPNotify::GetColorControls

IVPNotify Interface

Retrieves the current color control settings associated with the specified overlay or primary surface.

Syntax

HRESULT GetColorControls(
    LPDDCOLORCONTROL *ppColorControl
    ) PURE;

Parameters

ppColorControl
[out] Address of a pointer to the DDCOLORCONTROL structure that will receive the current control settings of the specified surface. The dwFlags member of the DDCOLORCONTROL structure indicates which of the color control options are supported.

Return Value

Returns an HRESULT value that depends on the implementation of the interface.
In the current Microsoft® DirectShow® implementation, this method returns NOERROR if successful, or E_INVALIDARG or E_FAIL upon failure.

IVPNotify::GetDeinterlaceMode

IVPNotify Interface

Retrieves the mode (such as bob or weave).

This method is not currently implemented and returns E_NOTIMPL.

Syntax

HRESULT GetDeinterlaceMode(
  AMVP_MODE *pmode
) PURE;

Parameters

pmode
[out] Pointer to the retrieved mode. This value is a member of the AMVP_MODE enumerated data type.

Return Value

Returns E_NOTIMPL.

IVPNotify::SetColorControls

IVPNotify Interface

Sets the color control settings associated with the specified overlay or primary surface.

Syntax

HRESULT SetColorControls(
    LPDDCOLORCONTROL pColorControl
    ) PURE;

Parameters

pColorControl
[in] Pointer to the DDCOLORCONTROL structure containing the new values to be applied to the specified surface.

Return Value

Returns an HRESULT value that depends on the implementation of the interface.
In the current DirectShow implementation, this method returns NOERROR if successful, or E_INVALIDARG or E_FAIL upon failure.

IVPNotify::SetDeinterlaceMode

IVPNotify Interface

Sets the mode (such as bob or weave).

Syntax

HRESULT SetDeinterlaceMode(
    AMVP_MODE mode
    ) PURE;

Parameters

mode
[in] Specified mode. This value is a member of the AMVP_MODE enumerated data type.

Return Value

Returns an HRESULT value that depends on the implementation of the interface.