## IVPNotify Interface

IVPNotify enables you to control the properties of a filter that uses a video port. This interface derives from the IVPBaseNotify interface. See also IVPBaseConfig and IVPConfig.

When to Implement

The Overlay Mixer filter implements this interface so you won't need to implement it in most cases. Implement this interface when you need to alter the default behavior.

When to Use

Use this interface in your application when you need to access video port properties.

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.

###

IVPNotify::GetColorControls

IVPNotify Interface

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

HRESULT GetColorControls(
LPDDCOLORCONTROL *ppColorControl
) PURE;

##### Parameters

ppColorControl
  [out] Address of 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 Values

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::GetDeinterlaceMode

IVPNotify Interface

Retrieves the mode (such as bob or weave).

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 Values

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

The current DirectShow implementation returns NOERROR for success or E_INVALIDARG if the argument is not valid.

##### Remarks

This method is not currently implemented and returns E_NOTIMPL.

###

IVPNotify::SetColorControls

IVPNotify Interface

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

HRESULT SetColorControls(
LPDDCOLORCONTROL pColorControl
) PURE;

##### Parameters

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

##### Return Values

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).

HRESULT SetDeinterlaceMode(
AMVP_MODE mode
) PURE;

##### Parameters

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

##### Return Values

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

The current DirectShow™ implementation returns NOERROR for success or E_INVALIDARG if mode is not a member of the AMVP_MODE enumerated data type.

##### Remarks

This method is not currently implemented and returns E_NOTIMPL.

© 1997 Microsoft Corporation. All rights reserved. Terms of Use.