Metodo ID3D12Device::CreateUnorderedAccessView (d3d12.h)

  • Articolo

Crea una visualizzazione per l'accesso non ordinato.

Sintassi

void CreateUnorderedAccessView(
       ID3D12Resource                         *pResource,
       ID3D12Resource                         *pCounterResource,
       const D3D12_UNORDERED_ACCESS_VIEW_DESC *pDesc,
  [in] D3D12_CPU_DESCRIPTOR_HANDLE            DestDescriptor
);

Parametri

pResource

Tipo: [in, facoltativo] ID3D12Resource*

Puntatore all'oggetto ID3D12Resource che rappresenta l'accesso non ordinato.

È necessario specificare almeno uno di pResource o pDesc .

Un valore pResource null viene usato per inizializzare un descrittore Null, che garantisce un comportamento di associazione Null simile a Direct3D 11 (lettura 0s, le scritture vengono eliminate), ma deve avere un pDesc valido per determinare il tipo di descrittore.

pCounterResource

Tipo: [in, facoltativo] ID3D12Resource*

ID3D12Resource per il contatore (se presente) associato all'UAV.

Se pCounterResource non viene specificato, il membro CounterOffsetInBytes della struttura D3D12_BUFFER_UAV deve essere 0.

Se si specifica pCounterResource , è presente un contatore associato all'UAV e il runtime esegue la convalida dei requisiti seguenti:

  • Il membro StructureByteStride della struttura D3D12_BUFFER_UAV deve essere maggiore di 0.
  • Il formato deve essere DXGI_FORMAT_UNKNOWN.
  • Il flag D3D12_BUFFER_UAV_FLAG_RAW (costante di enumerazione D3D12_BUFFER_UAV_FLAGS ) non deve essere impostato.
  • Entrambe le risorse (pResource e pCounterResource) devono essere buffer.
  • Il membro CounterOffsetInBytes della struttura D3D12_BUFFER_UAV deve essere un multiplo di **D3D12_UAV_COUNTER_PLACEMENT_ALIGNMENT** (4096) e deve essere compreso nell'intervallo della risorsa contatore.
  • pResource non può essere NULL
  • pDesc non può essere NULL.

pDesc

Tipo: [in, facoltativo] const D3D12_UNORDERED_ACCESS_VIEW_DESC*

Puntatore a una struttura D3D12_UNORDERED_ACCESS_VIEW_DESC che descrive la visualizzazione di accesso non ordinato.

Un pDesc null viene usato per inizializzare un descrittore predefinito, se possibile. Questo comportamento è identico al comportamento del descrittore Null D3D11, in cui vengono compilate le impostazioni predefinite. Questo comportamento eredita il formato della risorsa e la dimensione (se non senza tipi) e per i buffer gli UAV sono destinati a un buffer completo e vengono tipizzati e per le trame le UAV hanno come destinazione il primo mip e tutte le sezioni di matrice. Non tutte le risorse supportano l'inizializzazione del descrittore Null.

[in] DestDescriptor

Tipo: D3D12_CPU_DESCRIPTOR_HANDLE

Descrive l'handle del descrittore della CPU che rappresenta l'inizio dell'heap che contiene la visualizzazione di accesso non ordinato.

Valore restituito

nessuno

Requisiti

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

Vedi anche

ID3D12Device