ID3D11VideoContext：：VideoProcessorSetStreamPixelAspectRatio 方法 (d3d11.h)

设置视频处理器上输入流的像素纵横比。

语法

void VideoProcessorSetStreamPixelAspectRatio(
  [in] ID3D11VideoProcessor *pVideoProcessor,
  [in] UINT                 StreamIndex,
  [in] BOOL                 Enable,
  [in] const DXGI_RATIONAL  *pSourceAspectRatio,
  [in] const DXGI_RATIONAL  *pDestinationAspectRatio
);

参数

[in] pVideoProcessor

指向 ID3D11VideoProcessor 接口的 指针。 若要获取此指针，请调用 ID3D11VideoDevice：：CreateVideoProcessor。

[in] StreamIndex

输入流的从零开始的索引。 若要获取最大流数，请调用 ID3D11VideoProcessorEnumerator：：GetVideoProcessorCaps 并检查 MaxStreamStates 结构成员。

[in] Enable

指定 pSourceAspectRatio 和 pDestinationAspectRatio 参数是否包含有效值。 否则，像素纵横比未指定。

[in] pSourceAspectRatio

指向包含源矩形像素纵横比 的DXGI_RATIONAL 结构的指针。 如果 Enable 为 FALSE，则此参数可以为 NULL。

[in] pDestinationAspectRatio

指向包含目标矩形像素纵横比 的DXGI_RATIONAL 结构的指针。 如果 Enable 为 FALSE，则此参数可以为 NULL。

返回值

无

备注

仅当驱动程序报告 D3D11_VIDEO_PROCESSOR_FEATURE_CAPS_PIXEL_ASPECT_RATIO 功能时，才能调用此函数。 如果未设置此功能，则此函数将不起作用。

格式 0/n 和 n/0 的像素纵横比无效。

默认像素纵横比为 1：1 (平方像素) 。

要求

要求	值
最低受支持的客户端	Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器	Windows Server 2012 [桌面应用 |UWP 应用]
目标平台	Windows
标头	d3d11.h

另请参阅

ID3D11VideoContext

图片纵横比