IVPNotify enables you to control the properties of a filter that uses a video port.
When to Implement
The video port (VP) overlay mixer filter (Overlay Mixer) 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. |
| IVPNotify methods | Description |
| RenegotiateVPParameters | Initializes the connection to the decoder. |
| SetMode | Sets the mode (such as bob or weave). |
| GetMode | Retrieves the mode (such as bob or weave). |
Retrieves the mode (such as bob or weave).
HRESULT GetMode(
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 functional.
Initializes the connection to the decoder.
HRESULT RenegotiateVPParameters(void) PURE;
Returns an HRESULT value that depends on the implementation of the interface.
The VP mixer filter negotiates various parameters (by using the IVPConfig interface) with the decoder/driver. Call this function if any of those parameters (such as the video format or size) change. Currently, the VP mixer repeats the whole connection process. You can call this method even while the graph is playing.
Sets the mode (such as bob or weave).
HRESULT SetMode(
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 functional.
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.