DXVA_DeinterlaceContainerDeviceClass::DeinterlaceQueryModeCaps method

Article
12/15/2021

The sample DeinterlaceQueryModeCaps function queries the driver to determine the input capabilities of a particular deinterlace mode and any additional video processing that might be supported on that mode.

Syntax

HRESULT DeinterlaceQueryModeCaps(
  [in]  LPGUID               pGuidDeinterlaceMode,
  [in]  LPDXVA_VideoDesc     lpVideoDescription,
  [out] DXVA_DeinterlaceCaps *lpDeinterlaceCaps
);

Parameters

pGuidDeinterlaceMode [in] Supplies a pointer to the GUID used to specify the deinterlace mode.

lpVideoDescription [in] Supplies a pointer to a DXVA_VideoDesc structure that defines the type of video to be deinterlaced or rate-converted.

lpDeinterlaceCaps [out] Receives a pointer to a DXVA_DeinterlaceCaps structure that contains the capabilities of the deinterlace mode.

Return value

Returns zero (S_OK or DD_OK) if successful; otherwise, returns an error code. Refer to ddraw.h for a complete list of error codes.

Remarks

The driver is queried by the VMR for the capabilities of a deinterlace mode after the VMR has determined the deinterlace modes available for a particular video format. The driver returns available modes from a call to its DeinterlaceQueryAvailableModes function.

The DeinterlaceQueryModeCaps function reports the capabilities for a given mode in the DXVA_DeinterlaceCaps structure.

The lpVideoDescription parameter is passed to the driver so that the driver can support the resolution and format of the source video. For example, the driver might be able to perform a three-field adaptive deinterlace of 480i content, but it might only be able to bob 1080i content. For more information, see Video Content for Deinterlace and Frame-Rate Conversion.

All drivers should be able to support the bob mode using the existing bit-block transfer hardware.

Mapping RenderMoComp to DeinterlaceQueryModeCaps

The DeinterlaceQueryModeCaps function maps directly to a call to the RenderMoComp member of the DD_MOTIONCOMPCALLBACKS structure. The RenderMoComp member points to a display driver-supplied function that references the DD_RENDERMOCOMPDATA structure.

The RenderMoComp callback is called without the display driver-supplied BeginMoCompFrame or EndMoCompFrame function being called first.

The DD_RENDERMOCOMPDATA structure is filled as follows.

Member	Value
dwNumBuffers	Zero.
lpBufferInfo	NULL.
dwFunction	DXVA_DeinterlaceQueryAvailableModesFnCode constant (defined in dxva.h).
lpInputData	Pointer to a DXVA_DeinterlaceQueryModeCaps structure.
lpOutputData	Pointer to a DXVA_DeinterlaceCaps structure.

Requirements

Target platform	Desktop
Header	N/A (Declared in a driver-supplied header file)

Share via