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 |