Metodo ID3D12Device::CreateUnorderedAccessView (d3d12.h)

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

Vedi anche

ID3D12Device