IVMRDeinterlaceControl9::GetDeinterlaceModeCaps method (vmr9.h)

Article
4/26/2023

[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

Partager via