Microsoft DirectX 8.0

IVPBaseNotify Interface

Enables the Overlay Mixer to control the properties of a hardware device such as a decoder that uses a video port. The IVPNotify interface derives from this interface. See also IVPBaseConfig and IVPConfig.

Applications should never use this interface.

Requirements

Requires Vptype.h, Vpnotify.h.

Methods in Vtable Order

IUnknown methodsDescription
QueryInterface Retrieves pointers to supported interfaces.
AddRef Increments the reference count.
Release Decrements the reference count.
IVPBaseNotify methodsDescription
RenegotiateVPParameters Initializes the connection to the decoder.

IVPBaseNotify::RenegotiateVPParameters

IVPBaseNotify Interface

Initializes the connection to the decoder.

Syntax

HRESULT RenegotiateVPParameters(void) PURE;

Return Value

Returns an HRESULT value that depends on the implementation of the interface. HRESULT can include 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 is not supported.
NOERROR No error.

Remarks

The Overlay Mixer filter negotiates various parameters (by using the IVPBaseConfig interface) with the decoder or driver. Call this method if any of those parameters (such as the video format or size) change. Currently, the Overlay Mixer repeats the whole connection process. You can call this method even while the graph is playing.