IVMRDeinterlaceControl9 interface (vmr9.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 IVMRDeinterlaceControl9 interface supports hardware-accelerated deinterlacing using the Video Mixing Renderer Filter 9 (VMR-9). This interface enables applications or other filters to control how the VMR manages DirectX Video Acceleration (DirectX VA) hardware deinterlacing.

Inheritance

The IVMRDeinterlaceControl9 interface inherits from the IUnknown interface. IVMRDeinterlaceControl9 also has these types of members:

Methods

The IVMRDeinterlaceControl9 interface has these methods.

 
IVMRDeinterlaceControl9::GetActualDeinterlaceMode

The GetActualDeinterlaceMode method returns the deinterlacing mode that the VMR is using for a specified stream.
IVMRDeinterlaceControl9::GetDeinterlaceMode

The GetDeinterlaceMode method retrieves the deinterlacing mode for the specified video stream.
IVMRDeinterlaceControl9::GetDeinterlaceModeCaps

The GetDeinterlaceModeCaps method gets the capabilities of a deinterlacing mode supported by the graphics device driver.
IVMRDeinterlaceControl9::GetDeinterlacePrefs

The GetDeinterlacePrefs method queries how the VMR will select a deinterlacing mode if it cannot use the preferred deinterlacing mode.
IVMRDeinterlaceControl9::GetNumberOfDeinterlaceModes

The GetNumberOfDeinterlaceModes method retrieves the deinterlacing modes available to the VMR for the specified video format.
IVMRDeinterlaceControl9::SetDeinterlaceMode

The SetDeinterlaceMode method sets the deinterlacing mode for the specified video stream.
IVMRDeinterlaceControl9::SetDeinterlacePrefs

The SetDeinterlacePrefs method specifies how the VMR will select a deinterlacing mode if it cannot use the preferred deinterlacing mode.

Remarks

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.

To determine what de-interlacing modes are available, perform these steps:

  1. Create the VMR-9 and put it into mixing mode.
  2. Query the VMR-9 for the IVMRDeinterlaceControl9 interface
  3. Fill in a VMRVideoDesc structure that describes the format of the interlaced video.
  4. Call IVMRDeinterlaceControl9::GetNumberOfDeinterlaceModes to get the number of available de-interlacing modes.
  5. For each mode returned, call IVMRDeinterlaceControl::GetDeinterlaceModeCaps to get information about the mode.

Requirements

Requirement Value
Minimum supported client Windows XP with SP2 [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header vmr9.h

See also

Setting Deinterlace Preferences

Using the Video Mixing Renderer

Video Mixing Renderer Filter 9