Pular para o conteúdo principal
Define todos os elementos de uma exibição de acesso não ordenado (UAV) com os valores inteiros especificados.

Sintaxe

Parâmetros

ViewGPUHandleInCurrentHeap
Tipo: D3D12_GPU_DESCRIPTOR_HANDLE
Um D3D12_GPU_DESCRIPTOR_HANDLE que referencia um descritor inicializado para a exibição de acesso não ordenado (UAV) a ser limpa. Esse descritor deve estar em um heap de descritores visível ao sombreador, que deve ser definido na lista de comandos por meio de SetDescriptorHeaps. ViewCPUHandle
Tipo: D3D12_CPU_DESCRIPTOR_HANDLE
Um D3D12_CPU_DESCRIPTOR_HANDLE em um heap de descritores não visível ao sombreador que referencia um descritor inicializado para a exibição de acesso não ordenado (UAV) a ser limpa.
Esse descritor não deve estar em um heap de descritores visível ao sombreador. Isso permite que drivers que implementam a limpeza como uma operação de hardware de função fixa (em vez de um dispatch) leiam o descritor com eficiência, pois heaps visíveis ao sombreador podem ser criados em memória WRITE_BACK (semelhante aos tipos de heap D3D12_HEAP_TYPE_UPLOAD), e leituras da CPU nesse tipo de memória são extremamente lentas.
pResource
Tipo: ID3D12Resource *
Um ponteiro para a interface ID3D12Resource que representa o recurso de exibição de acesso não ordenado (UAV) a ser limpo. Values
Tipo: const UINT *
Uma matriz de 4 componentes que contém os valores com os quais preencher o recurso de exibição de acesso não ordenado. NumRects
Tipo: UINT
O número de retângulos na matriz especificada pelo parâmetro pRects. pRects
Tipo: const D3D12_RECT *
Uma matriz de estruturas D3D12_RECT para os retângulos na exibição de recurso a serem limpos. Se for NULL, ClearUnorderedAccessViewUint limpará toda a exibição de recurso.

Valor retornado

Tipo: void Nenhum.

Comentários

Validação do runtime

Uma falha de validação faz com que a chamada para ID3D12GraphicsCommandList::Close retorne E_INVALIDARG.

Camada de depuração

A camada de depuração emite erros se os valores de entrada estiverem fora de um intervalo normalizado. A camada de depuração emite um erro se os sub-recursos referenciados pela exibição não estiverem no estado apropriado. Para ClearUnorderedAccessViewUint, o estado deve ser D3D12_RESOURCE_STATE_UNORDERED_ACCESS.

Requisitos

Cabeçalho: d3d12_xs.h ou d3d12_x.h
Biblioteca: d3d12_xs.lib ou d3d12_x.lib
Plataformas com suporte: consoles XBOX Series e família XBOX One

Confira também

Interface ID3D12GraphicsCommandList
Última modificação em 6 de outubro de 2026