IVMRDeinterlaceControl interface (strmif.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.]
The IVMRDeinterlaceControl interface provides support for advanced hardware-accelerated deinterlacing using the Video Mixing Renderer Filter 7 (VMR-7). This interface enables applications or other filters to control how the VMR manages DirectX Video Acceleration (DirectX VA) hardware deinterlacing.
Inheritance
The IVMRDeinterlaceControl interface inherits from the IUnknown interface. IVMRDeinterlaceControl also has these types of members:
Methods
The IVMRDeinterlaceControl interface has these methods.
| IVMRDeinterlaceControl::GetActualDeinterlaceMode The GetActualDeinterlaceMode method returns the deinterlacing mode that the VMR is using for a specified stream. |
| IVMRDeinterlaceControl::GetDeinterlaceMode The GetDeinterlaceMode method retrieves the deinterlacing mode for the specified video stream. |
| IVMRDeinterlaceControl::GetDeinterlaceModeCaps The GetDeinterlaceModeCaps method retrieves the capabilities of a specific deinterlacing mode supported by the graphics device driver. |
| IVMRDeinterlaceControl::GetDeinterlacePrefs The GetDeinterlacePrefs method queries how the VMR will select a deinterlacing mode if it cannot use the preferred deinterlacing mode. |
| IVMRDeinterlaceControl::GetNumberOfDeinterlaceModes The GetNumberOfDeinterlaceModes method retrieves the deinterlacing modes available to the VMR for the specified video format. |
| IVMRDeinterlaceControl::SetDeinterlaceMode The SetDeinterlaceMode method sets the deinterlacing mode for the specified video stream. |
| IVMRDeinterlaceControl::SetDeinterlacePrefs The SetDeinterlacePrefs method specifies how the VMR will select a deinterlacing mode if it cannot use the preferred deinterlacing mode. |
Remarks
This interface is applicable only when the VMR is in mixer mode. All methods in this interface return VFW_E_VMR_NOT_IN_MIXER_MODE if the VMR is not in mixer mode.
Deinterlacing modes are identified by GUIDs. The graphics device driver returns an array of GUIDs for the modes that it supports. The array is sorted in order of quality, from best quality to lowest quality. To retrieve the list of GUIDs, call the GetNumberOfDeinterlaceModes method. To obtain more information about a particular mode, pass this GUID to the GetDeinterlaceModeCaps method. To configure the VMR to use a particular mode, call the SetDeinterlaceMode method.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP with SP1 [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | strmif.h (include Dshow.h) |