语法
参数
ViewGPUHandleInCurrentHeap类型:D3D12_GPU_DESCRIPTOR_HANDLE 一个 D3D12_GPU_DESCRIPTOR_HANDLE,它引用要清除的无序访问视图 (UAV) 的已初始化描述符。此描述符必须位于着色器可见的描述符堆中,并且该堆必须通过 SetDescriptorHeaps 设置到命令列表上。 ViewCPUHandle
类型:D3D12_CPU_DESCRIPTOR_HANDLE 位于非着色器可见描述符堆中的 D3D12_CPU_DESCRIPTOR_HANDLE,它引用要清除的无序访问视图 (UAV) 的已初始化描述符。
此描述符不得位于着色器可见的描述符堆中。这是为了让将清除操作实现为固定功能硬件操作(而非调度)的驱动程序能够高效地从描述符中读取,因为着色器可见的堆可能在 WRITE_BACK 内存中创建(类似于 D3D12_HEAP_TYPE_UPLOAD 堆类型),而 CPU 从此类内存中读取的速度非常慢。
类型:ID3D12Resource * 指向 ID3D12Resource 接口的指针,该接口表示要清除的无序访问视图 (UAV) 资源。 Values
类型:const UINT * 包含用于填充无序访问视图资源的值的 4 分量数组。 NumRects
类型:UINT pRects 参数指定的数组中的矩形数量。 pRects
类型:const D3D12_RECT * 要清除的资源视图中矩形的 D3D12_RECT 结构数组。如果为 NULL,则 ClearUnorderedAccessViewUint 清除整个资源视图。
返回值
类型:void 无。备注
运行时验证
验证失败将导致对 ID3D12GraphicsCommandList::Close 的调用返回 E_INVALIDARG。调试层
如果输入值超出正规范围,调试层将发出错误。 如果视图引用的子资源不在适当的状态,调试层将发出错误。对于 ClearUnorderedAccessViewUint,状态必须为 D3D12_RESOURCE_STATE_UNORDERED_ACCESS。要求
头文件: d3d12_xs.h 或 d3d12_x.h库: d3d12_xs.lib 或 d3d12_x.lib
支持的平台:XBOX Series 主机和 XBOX One 系列
