Sintaxe
Parâmetros
ViewGPUHandleInCurrentHeapTipo: 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.
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 FLOAT * 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, ClearUnorderedAccessViewFloat limpará toda a exibição de recurso.
Valor retornado
Tipo: void Nenhum.Comentários
Validação do runtime
Para entradas de ponto flutuante, o runtime define valores desnormalizados como 0 (preservando os NANs). Se você quiser limpar a UAV com um padrão de bits específico, considere usar ID3D12GraphicsCommandList::ClearUnorderedAccessViewUint. 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 ClearUnorderedAccessViewFloat, o estado deve ser D3D12_RESOURCE_STATE_UNORDERED_ACCESS.Requisitos
Cabeçalho: d3d12_xs.h ou d3d12_x.hBiblioteca: d3d12_xs.lib ou d3d12_x.lib
Plataformas com suporte: consoles XBOX Series e família XBOX One