Share via

Método ID3D12Device::CreateUnorderedAccessView (d3d12.h)

  • Artigo

Cria uma exibição para acesso não ordenado.

Sintaxe

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

Parâmetros

pResource

Tipo: [in, opcional] ID3D12Resource*

Um ponteiro para o objeto ID3D12Resource que representa o acesso não ordenado.

Pelo menos um pResource ou pDesc deve ser fornecido.

Um pResource nulo é usado para inicializar um descritor nulo, que garante o comportamento de associação nula semelhante ao Direct3D 11 (leitura 0s, gravações são descartadas), mas deve ter um pDesc válido para determinar o tipo de descritor.

pCounterResource

Tipo: [in, opcional] ID3D12Resource*

O ID3D12Resource para o contador (se houver) associado ao UAV.

Se pCounterResource não for especificado, o membro CounterOffsetInBytes da estrutura D3D12_BUFFER_UAV deverá ser 0.

Se pCounterResource for especificado, haverá um contador associado ao UAV e o runtime executará a validação dos seguintes requisitos:

  • O membro StructureByteStride da estrutura D3D12_BUFFER_UAV deve ser maior que 0.
  • O formato deve ser DXGI_FORMAT_UNKNOWN.
  • O sinalizador D3D12_BUFFER_UAV_FLAG_RAW (uma constante de enumeração D3D12_BUFFER_UAV_FLAGS ) não deve ser definido.
  • Ambos os recursos (pResource e pCounterResource) devem ser buffers.
  • O membro CounterOffsetInBytes da estrutura D3D12_BUFFER_UAV deve ser um múltiplo de **D3D12_UAV_COUNTER_PLACEMENT_ALIGNMENT** (4096) e deve estar dentro do intervalo do recurso de contador.
  • pResource não pode ser NULL
  • pDesc não pode ser NULL.

pDesc

Tipo: [in, opcional] const D3D12_UNORDERED_ACCESS_VIEW_DESC*

Um ponteiro para uma estrutura D3D12_UNORDERED_ACCESS_VIEW_DESC que descreve a exibição de acesso não ordenado.

Um pDesc nulo é usado para inicializar um descritor padrão, se possível. Esse comportamento é idêntico ao comportamento do descritor nulo D3D11, em que os padrões são preenchidos. Esse comportamento herda o formato e a dimensão do recurso (se não for sem tipo) e para buffers UAVs têm como destino um buffer completo e são digitados e, para texturas, os UAVs visam o primeiro mip e todas as fatias de matriz. Nem todos os recursos dão suporte à inicialização do descritor nulo.

[in] DestDescriptor

Tipo: D3D12_CPU_DESCRIPTOR_HANDLE

Descreve o identificador do descritor de CPU que representa o início do heap que contém a exibição de acesso não ordenado.

Valor retornado

Nenhum

Requisitos

   
Plataforma de Destino Windows
Cabeçalho d3d12.h
Biblioteca D3D12.lib
DLL D3D12.dll

Confira também

ID3D12Device