IVMRDeinterlaceControl::GetDeinterlaceModeCaps method (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 GetDeinterlaceModeCaps method retrieves the capabilities of a specific deinterlacing mode supported by the graphics device driver.

Syntax

HRESULT GetDeinterlaceModeCaps(
  [in]  LPGUID             lpDeinterlaceMode,
  [in]  VMRVideoDesc       *lpVideoDescription,
  [out] VMRDeinterlaceCaps *lpDeinterlaceCaps
);

Parameters

[in] lpDeinterlaceMode

Pointer to a GUID that identifies the deinterlacing mode. Call the GetNumberOfDeinterlaceModes method to obtain a list of GUIDs supported by the driver.

[in] lpVideoDescription

Pointer to a VMRVideoDesc structure describing the video to deinterlace. Set the dwSize member of the structure before calling the method.

[out] lpDeinterlaceCaps

Pointer to a VMRDeinterlaceCaps structure. Set the dwSize member of the structure before calling the method. The method fills the structure with information about the specified deinterlacing mode.

Return value

Returns an HRESULT value. Possible values include the following:

Return code Description
E_POINTER
NULL pointer argument.
S_OK
Success.
E_INVALIDARG
Invalid argument.
VFW_E_DDRAW_CAPS_NOT_SUITABLE
The video card does not support hardware deinterlacing.
VFW_E_VMR_NO_DEINTERLACE_HW
The video card does not support hardware deinterlacing.
VFW_E_VMR_NOT_IN_MIXER_MODE
The VMR is not in mixer mode.

Remarks

The method returns VMRVideoDesc and VMRDeinterlaceCaps structures.

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)
Library Strmiids.lib

See also

Error and Success Codes

IVMRDeinterlaceControl Interface

Using the Video Mixing Renderer