Freigeben über


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

Syntax

HRESULT GetDeinterlaceModeCaps(
  [in]  LPGUID              lpDeinterlaceMode,
  [in]  VMR9VideoDesc       *lpVideoDescription,
  [out] VMR9DeinterlaceCaps *lpDeinterlaceCaps
);

Parameters

[in] lpDeinterlaceMode

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

[in] lpVideoDescription

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

[out] lpDeinterlaceCaps

Pointer to a VMR9DeinterlaceCaps 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 E_INVALIDARG if you do not set the dwSize member in the VMR9VideoDesc and VMR9DeinterlaceCaps structures.

Requirements

Requirement Value
Minimum supported client Windows XP with SP2 [desktop apps only]
Minimum supported server Windows Server 2003 R2 [desktop apps only]
Target Platform Windows
Header vmr9.h
Library Strmiids.lib

See also

Error and Success Codes

IVMRDeinterlaceControl9 Interface

Setting Deinterlace Preferences

Using the Video Mixing Renderer

Video Mixing Renderer Filter 9