Edit

Share via

PFND3D11_1DDI_VIDEOPROCESSORSETSTREAMPIXELASPECTRATIO callback function (d3d10umddi.h)

  • Article

Sets the pixel aspect ratio for an input stream on the video processor.

Syntax

PFND3D11_1DDI_VIDEOPROCESSORSETSTREAMPIXELASPECTRATIO Pfnd3d111DdiVideoprocessorsetstreampixelaspectratio;

void Pfnd3d111DdiVideoprocessorsetstreampixelaspectratio(
  D3D10DDI_HDEVICE unnamedParam1,
  D3D11_1DDI_HVIDEOPROCESSOR unnamedParam2,
  UINT unnamedParam3,
  BOOL unnamedParam4,
  const DXGI_RATIONAL *unnamedParam5,
  const DXGI_RATIONAL *unnamedParam6
)
{...}

Parameters

unnamedParam1

hDevice [in]

A handle to the display device (graphics context).

unnamedParam2

hVideoProcessor [in]

A handle to the video processor object that was created through a call to the CreateVideoProcessor function.

unnamedParam3

StreamIndex [in]

The zero-based index of the input stream.

unnamedParam4

Enable [in]

If TRUE, the pSourceRatio and pDestinationRatio parameters contain valid values. Otherwise, the pixel aspect ratios are unspecified.

unnamedParam5

pSourceRatio [in]

A pointer to a DXGI_RATIONAL structure that contains the pixel aspect ratio of the source rectangle.

Note  If the Enable parameter is FALSE, this parameter can be NULL.
 

unnamedParam6

pDestRatio [in]

A pointer to a DXGI_RATIONAL structure that contains the pixel aspect ratio of the destination rectangle.

Note  If the Enable parameter is FALSE, this parameter can be NULL.
 

Return value

None

Remarks

Pixel aspect ratios of the form 0/n and n/0 are not valid.

The default pixel aspect ratio is 1:1 (square pixels).

The driver reports its ability to support the pixel aspect ratio capability in the D3D11_1DDI_VIDEO_PROCESSOR_CAPS structure that is returned through the GetVideoProcessorCaps function. If the driver supports the D3D11_1DDI_VIDEO_PROCESSOR_FEATURE_CAPS_PIXEL_ASPECT_RATIO capability, the VideoProcessorSetStreamAlpha can be called to set the pixel aspect ratios for an input stream of the video processor.

Note  If the driver does not support the D3D11_1DDI_VIDEO_PROCESSOR_FEATURE_CAPS_PIXEL_ASPECT_RATIO capability, the Microsoft Direct3D runtime does not call the VideoProcessorSetStreamAlpha function.
 

Requirements

Requirement Value
Minimum supported client Windows 8
Minimum supported server Windows Server 2012
Target Platform Desktop
Header d3d10umddi.h (include D3d10umddi.h)

See also

CreateVideoProcessor

D3D11_1DDI_VIDEO_PROCESSOR_CAPS

GetVideoProcessorCaps