ID3D11VideoDevice1::RecommendVideoDecoderDownsampleParameters method

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

pInputDesc [in]

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.

InputColorSpace [in]

Type: DXGI_COLOR_SPACE_TYPE

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

pInputConfig [in]

Type: const D3D11_VIDEO_DECODER_CONFIG*

The configuration data associated with the decode profile.

pFrameRate [in]

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.

pRecommendedOutputDesc [out]

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.

S_OK	The operation completed successfully.
E_INVALIDARG	An invalid parameter was passed or this function was called using an invalid calling pattern.

Remarks

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

Requirements

Minimum supported client	Windows 10 [desktop apps only]
Minimum supported server	Windows Server 2016 [desktop apps only]
Header	D3d11_1.h