ID3D11DeviceContext：：RSGetViewports 方法 (d3d11.h)

  • 项目

获取绑定到光栅器阶段的视区数组。

语法

void RSGetViewports(
  [in, out]       UINT           *pNumViewports,
  [out, optional] D3D11_VIEWPORT *pViewports
);

参数

[in, out] pNumViewports

类型： UINT*

指向变量的指针，该变量在输入时指定 (范围从 0 到 D3D11_VIEWPORT_AND_SCISSORRECT_OBJECT_COUNT_PER_PIPELINE) pViewports 数组中的视区数;输出时， 变量包含绑定到光栅器阶段的实际视区数。 如果 pViewports 为 NULL， 则 RSGetViewports 使用当前绑定的视区数填充变量。

注意在某些版本的 Windows SDK 中，如果 pNumViewports 指向的变量中的输入值大于 D3D11_VIEWPORT_AND_SCISSORRECT_OBJECT_COUNT_PER_PIPELINE即使 pViewports 为 NULL，调试设备也会引发异常。 当 pViewports 为 NULL 时，常规运行时会忽略 pNumViewports 指向的变量中的值。 调试设备的此行为可能会在 Windows SDK 的未来版本中得到更正。
 

[out, optional] pViewports

类型： D3D11_VIEWPORT*

绑定到光栅器阶段的视区 D3D11_VIEWPORT 结构的数组。 如果 pNumViewports) 指向的变量中 (视区数大于当前绑定的实际视区数，则数组的未使用元素包含 0。 有关视区大小如何取决于设备 功能级别（在 Direct3D 11 和 Direct3D 10 之间已更改）的信息，请参阅 D3D11_VIEWPORT。

返回值

无

备注

Windows Phone 8：支持此 API。

要求

   
目标平台 Windows
标头 d3d11.h
Library D3D11.lib

另请参阅

ID3D11DeviceContext