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. |
Retrieves the current color control settings associated with the specified overlay or primary surface.
HRESULT GetColorControls(
LPDDCOLORCONTROL *ppColorControl
) PURE;
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.
Retrieves the mode (such as bob or weave).
HRESULT GetDeinterlaceMode(
AMVP_MODE *pmode
) PURE;
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.
This method is not currently implemented and returns E_NOTIMPL.
Sets the color control settings associated with the specified overlay or primary surface.
HRESULT SetColorControls(
LPDDCOLORCONTROL pColorControl
) PURE;
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.
Sets the mode (such as bob or weave).
HRESULT SetDeinterlaceMode(
AMVP_MODE mode
) PURE;
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.
This method is not currently implemented and returns E_NOTIMPL.
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.