Método ID3D12GraphicsCommandList::ClearUnorderedAccessViewUint (d3d12.h)
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 |