IVPBaseConfig interface (vpconfig.h)
[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
IVPBaseConfig is implemented on a filter that wraps a hardware device such as a decoder or capture device, if the device has a video port to the graphics adapter. This interface allows the video port to communicate with the Overlay Mixer filter regarding configuration information. The IVPConfig interface derives from this interface.
Applications should never use this interface.
Inheritance
The IVPBaseConfig interface inherits from the IUnknown interface. IVPBaseConfig also has these types of members:
Methods
The IVPBaseConfig interface has these methods.
| IVPBaseConfig::GetConnectInfo The GetConnectInfo method retrieves information about the connections supported by the VPE object. |
| IVPBaseConfig::GetMaxPixelRate The GetMaxPixelRate method retrieves the maximum pixel rate the device will output for a given width and height. |
| IVPBaseConfig::GetOverlaySurface The GetOverlaySurface method queries whether the caller should use the driver's overlay surface. If so, the method returns a pointer to the surface. |
| IVPBaseConfig::GetVideoFormats The GetVideoFormats method retrieves the video formats the driver supports. |
| IVPBaseConfig::GetVPDataInfo The GetVPDataInfo method retrieves the current video port data information. |
| IVPBaseConfig::InformVPInputFormats The InformVPInputFormats method informs the device what video formats the video port supports. |
| IVPBaseConfig::SetConnectInfo The SetConnectInfo method sets the video port connection parameters. |
| IVPBaseConfig::SetDDSurfaceKernelHandles The SetDDSurfaceKernelHandles method specifies the kernel-mode handles of the DirectDraw surfaces to be used for the overlay surface. |
| IVPBaseConfig::SetDirectDrawKernelHandle The SetDirectDrawKernelHandle method sets the kernel-mode handle to the DirectDraw object. This handle enables the device's mini-driver to communicate with DirectDraw. |
| IVPBaseConfig::SetInvertPolarity The SetInvertPolarity method reverses the current polarity the device uses. |
| IVPBaseConfig::SetSurfaceParameters The SetSurfaceParameters method informs the device of the layout of the overlay surface. The downstream filter (the Overlay Mixer, VBI Surface Allocator, or Video Port Manager) calls this method after it creates the overlay surface. |
| IVPBaseConfig::SetVideoFormat The SetVideoFormat method sets the video format. |
| IVPBaseConfig::SetVideoPortID The SetVideoPortID method specifies the ID of the hardware video port to use. |
Remarks
Include Dvp.h and Vptype.h before Vpconfig.h.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | vpconfig.h |