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 数组中的视区数;输出时, 变量包含绑定到光栅器阶段的实际视区数。 如果 pViewportsNULL则 RSGetViewports 使用当前绑定的视区数填充变量。

注意在某些版本的 Windows SDK 中,如果 pNumViewports 指向的变量中的输入值大于 D3D11_VIEWPORT_AND_SCISSORRECT_OBJECT_COUNT_PER_PIPELINE即使 pViewportsNULL调试设备也会引发异常。 当 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