ID3D11VideoDevice1::RecommendVideoDecoderDownsampleParameters method (d3d11_1.h)

Allows the driver to recommend optimal output downsample parameters from the input parameters.

Syntax

HRESULT RecommendVideoDecoderDownsampleParameters(
  [in]  const D3D11_VIDEO_DECODER_DESC   *pInputDesc,
  [in]  DXGI_COLOR_SPACE_TYPE            InputColorSpace,
  [in]  const D3D11_VIDEO_DECODER_CONFIG *pInputConfig,
  [in]  const DXGI_RATIONAL              *pFrameRate,
  [out] D3D11_VIDEO_SAMPLE_DESC          *pRecommendedOutputDesc
);

Parameters

[in] pInputDesc

Type: const D3D11_VIDEO_DECODER_DESC*

A D3D11_VIDEO_DECODER_DESC object describing the decoding profile, the resolution, and format of the input stream. This is the resolution and format to be downsampled.

[in] InputColorSpace

Type: DXGI_COLOR_SPACE_TYPE

A DXGI_COLOR_SPACE_TYPE value that specifies the colorspace of the reference frame data.

[in] pInputConfig

Type: const D3D11_VIDEO_DECODER_CONFIG*

The configuration data associated with the decode profile.

[in] pFrameRate

Type: const DXGI_RATIONAL*

The frame rate of the video content. This is used by the driver to determine whether the video can be decoded in real-time.

[out] pRecommendedOutputDesc

Type: D3D11_VIDEO_SAMPLE_DESC*

Pointer to a D3D11_VIDEO_SAMPLE_DESC structure that the driver populates with the recommended output buffer parameters for a downsample operation. The driver will attempt to recommend parameters that can support real-time decoding. If it is unable to do so, the driver will recommend values that are as close to the real-time solution as possible.

Return value

Type: HRESULT

This method returns one of the following error codes.

Remarks

You should call GetVideoDecoderCaps to determine whether decoder downsampling is supported before checking support for a specific configuration.

Requirements

See also

ID3D11VideoDevice1