Método ID3D12GraphicsCommandList::ClearUnorderedAccessViewUint (d3d12.h)

  • Artigo

Define todos os elementos em uma exibição de acesso não ordenado (UAV) para os valores inteiros especificados.

Importante

Isso se comporta como uma operação de computação, pois não é ordenada em relação ao trabalho ao redor, como chamadas de expedição . Para garantir a ordenação, as chamadas de barreira devem ser emitidas antes e/ou depois da chamada ClearUnorderedAccessViewXxx, conforme necessário. Pode aparecer em alguns drivers que tais barreiras não são necessárias. Mas as barreiras implícitas não são uma garantia de especificação; para que eles não possam ser confiados. Isso contrasta com ClearDepthStencilView e ClearRenderTargetView que (como comandos DrawXxx ), respeitam a ordenação da lista de comandos.

Sintaxe

void ClearUnorderedAccessViewUint(
  D3D12_GPU_DESCRIPTOR_HANDLE ViewGPUHandleInCurrentHeap,
  D3D12_CPU_DESCRIPTOR_HANDLE ViewCPUHandle,
  ID3D12Resource              *pResource,
  const UINT [4]              Values,
  UINT                        NumRects,
  const D3D12_RECT            *pRects
);

Parâmetros

ViewGPUHandleInCurrentHeap

Tipo: [in] D3D12_GPU_DESCRIPTOR_HANDLE

Um D3D12_GPU_DESCRIPTOR_HANDLE que faz referência a um descritor inicializado para o UAV (modo de exibição de acesso não ordenado) que deve ser limpo. Esse descritor deve estar em um heap de descritor visível por sombreador, que deve ser definido na lista de comandos por meio de SetDescriptorHeaps.

ViewCPUHandle

Tipo: [in] D3D12_CPU_DESCRIPTOR_HANDLE

Um D3D12_CPU_DESCRIPTOR_HANDLE em um heap de descritor visível não sombreador que faz referência a um descritor inicializado para o UAV (modo de exibição de acesso não ordenado) que deve ser limpo.

Importante

Esse descritor não deve estar em um heap de descritor visível por sombreador. Isso é para permitir que os drivers que implementam o clear como uma operação de hardware de função fixa (em vez de como uma expedição) leiam com eficiência do descritor, pois heaps visíveis de sombreador podem ser criados na memória WRITE_BACK (semelhante a D3D12_HEAP_TYPE_UPLOAD tipos de heap) e as leituras de CPU desse tipo de memória são proibitivamente lentas.

pResource

Tipo: [in] ID3D12Resource*

Um ponteiro para a interface ID3D12Resource que representa o recurso UAV (unordered-access-view) a ser limpo.

Values

Tipo: [in] const UINT[4]

Uma matriz de quatro componentes que contém os valores com os quais preencher o recurso unordered-access-view.

NumRects

Tipo: [in] UINT

O número de retângulos na matriz especificada pelo parâmetro pRects .

pRects

Tipo: [in] const D3D12_RECT*

Uma matriz de estruturas D3D12_RECT para os retângulos na exibição de recursos a serem limpos. Se FOR NULL, ClearUnorderedAccessViewUint limpará toda a exibição de recursos.

Retornar valor

Nenhum

Comentários

Validação de runtime

A falha de validação resulta na chamada para ID3D12GraphicsCommandList::Close retornando E_INVALIDARG.

Camada de depuração

A camada de depuração emitirá erros se os valores de entrada estiverem fora de um intervalo normalizado.

A camada de depuração emitirá 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

Requisito Valor
Plataforma de Destino Windows
Cabeçalho d3d12.h
Biblioteca D3d12.lib
DLL D3d12.dll

Confira também

Interface ID3D12GraphicsCommandList