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

  • Artículo

Crea una vista para el acceso desordenado.

Sintaxis

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*

Puntero al objeto ID3D12Resource que representa el acceso no ordenado.

Debe proporcionarse al menos uno de pResource o pDesc .

Un valor pResource nulo se usa para inicializar un descriptor null, que garantiza el comportamiento de enlace null similar a Direct3D 11 (lectura 0, se descartan las escrituras), pero debe tener un pDesc válido para determinar el tipo de descriptor.

pCounterResource

Tipo: [in, opcional] ID3D12Resource*

Id3D12Resource para el contador (si existe) asociado al UAV.

Si no se especifica pCounterResource , el miembro CounterOffsetInBytes de la estructura D3D12_BUFFER_UAV debe ser 0.

Si se especifica pCounterResource , hay un contador asociado al UAV y el tiempo de ejecución realiza la validación de los siguientes requisitos:

  • El miembro StructureByteStride de la estructura D3D12_BUFFER_UAV debe ser mayor que 0.
  • El formato debe ser DXGI_FORMAT_UNKNOWN.
  • No se debe establecer la marca D3D12_BUFFER_UAV_FLAG_RAW (una constante de enumeración D3D12_BUFFER_UAV_FLAGS ).
  • Ambos recursos (pResource y pCounterResource) deben ser búferes.
  • El miembro CounterOffsetInBytes de la estructura D3D12_BUFFER_UAV debe ser un múltiplo de **D3D12_UAV_COUNTER_PLACEMENT_ALIGNMENT** (4096) y debe estar dentro del intervalo del recurso de contador.
  • pResource no puede ser NULL
  • pDesc no puede ser NULL.

pDesc

Tipo: [in, opcional] const D3D12_UNORDERED_ACCESS_VIEW_DESC*

Puntero a una estructura de D3D12_UNORDERED_ACCESS_VIEW_DESC que describe la vista de acceso desordenado.

Un pDesc nulo se usa para inicializar un descriptor predeterminado, si es posible. Este comportamiento es idéntico al comportamiento del descriptor null D3D11, donde se rellenan los valores predeterminados. Este comportamiento hereda el formato de recurso y la dimensión (si no no tienen tipos) y para los búferes tienen como destino un búfer completo y se escriben, y para las texturas las UAV tienen como destino el primer mip y todos los segmentos de matriz. No todos los recursos admiten la inicialización de descriptores NULL.

[in] DestDescriptor

Tipo: D3D12_CPU_DESCRIPTOR_HANDLE

Describe el identificador del descriptor de CPU que representa el inicio del montón que contiene la vista de acceso desordenado.

Valor devuelto

None

Requisitos

   
Plataforma de destino Windows
Encabezado d3d12.h
Library D3D12.lib
Archivo DLL D3D12.dll

Consulte también

ID3D12Device