Metodo ID3D12GraphicsCommandList::ClearUnorderedAccessViewFloat (d3d12.h)

Articolo
08/23/2023

Imposta tutti gli elementi in una visualizzazione di accesso non ordinata (UAV) ai valori float specificati.

Sintassi

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

Parametri

ViewGPUHandleInCurrentHeap

Tipo: [in] D3D12_GPU_DESCRIPTOR_HANDLE

D3D12_GPU_DESCRIPTOR_HANDLE che fa riferimento a un descrittore inizializzato per la visualizzazione di accesso non ordinata (UAV) che deve essere cancellata. Questo descrittore deve trovarsi in un heap descrittore visibile dello shader, che deve essere impostato nell'elenco dei comandi tramite SetDescriptorHeaps.

ViewCPUHandle

Tipo: [in] D3D12_CPU_DESCRIPTOR_HANDLE

Un D3D12_CPU_DESCRIPTOR_HANDLE in un heap visibile non shader che fa riferimento a un descrittore inizializzato per la visualizzazione di accesso non ordinata che deve essere cancellata.

Importante

Questo descrittore non deve essere in un heap visibile dello shader. Ciò consente ai driver che implementano la cancellazione come operazione hardware a funzione fissa (anziché come invio) di leggere in modo efficiente dal descrittore, poiché gli heaps visibili dello shader possono essere creati in memoria WRITE_BACK (analogamente ai tipi heap D3D12_HEAP_TYPE_UPLOAD) e le letture della CPU da questo tipo di memoria sono proibitivamente lente.

pResource

Tipo: [in] ID3D12Resource*

Puntatore all'interfaccia ID3D12Resource che rappresenta la risorsa UAV (unrdered-access-view) da cancellare.

Values

Tipo: [in] const FLOAT[4]

Matrice a 4 componenti che contiene i valori per riempire la risorsa di visualizzazione non ordinata con.

NumRects

Tipo: [in] UINT

Numero di rettangoli nella matrice specificata dal parametro pRects .

pRects

Tipo: [in] const D3D12_RECT*

Matrice di strutture D3D12_RECT per i rettangoli nella visualizzazione risorsa da cancellare. Se NULL, ClearUnorderedAccessViewFloat cancella l'intera visualizzazione delle risorse.

Valore restituito

nessuno

Osservazioni

Convalida runtime

Per gli input a virgola mobile, il runtime imposta i valori denormalizzati su 0 (mantenendo i valori NAN).

Se si vuole cancellare l'UAV in un modello di bit specifico, è consigliabile usare ID3D12GraphicsCommandList::ClearUnorderedAccessViewUint.

L'errore di convalida genera la chiamata a ID3D12GraphicsCommandList::Close restituisce E_INVALIDARG.

Livello di debug

Il livello di debug genera errori se i valori di input non sono compresi in un intervallo normalizzato.

Il livello di debug genera un errore se le sottoresource a cui fa riferimento la vista non si trovano nello stato appropriato. Per ClearUnorderedAccessViewFloat, lo stato deve essere D3D12_RESOURCE_STATE_UNORDERED_ACCESS.

Requisiti


Piattaforma di destinazione	Windows
Intestazione	d3d12.h
Libreria	D3d12.lib
DLL	D3d12.dll

Vedi anche

Interfaccia ID3D12GraphicsCommandList

Share via