Método ID3D12GraphicsCommandList::ClearUnorderedAccessViewUint (d3d12.h)

  • Artículo

Establece todos los elementos de una vista de acceso sin ordenar (UAV) en los valores enteros especificados.

Sintaxis

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

Parámetros

ViewGPUHandleInCurrentHeap

Tipo: [in] D3D12_GPU_DESCRIPTOR_HANDLE

Un D3D12_GPU_DESCRIPTOR_HANDLE que hace referencia a un descriptor inicializado para la vista de acceso desordenado (UAV) que se va a borrar. Este descriptor debe estar en un montón de descriptores visibles para sombreador, que debe establecerse en la lista de comandos a través de SetDescriptorHeaps.

ViewCPUHandle

Tipo: [in] D3D12_CPU_DESCRIPTOR_HANDLE

Un D3D12_CPU_DESCRIPTOR_HANDLE en un montón de descriptores visibles no sombreador que hace referencia a un descriptor inicializado para la vista de acceso no ordenado (UAV) que se va a borrar.

Importante

Este descriptor no debe estar en un montón de descriptores visibles para sombreador. Esto es para permitir que los controladores que implementan la claridad como una operación de hardware de función fija (en lugar de como un envío) se lean eficazmente desde el descriptor, ya que los montones visibles para sombreador se pueden crear en WRITE_BACK memoria (similar a D3D12_HEAP_TYPE_UPLOAD tipos de montón) y las lecturas de CPU de este tipo de memoria son prohibitivamente lentas.

pResource

Tipo: [in] ID3D12Resource*

Puntero a la interfaz ID3D12Resource que representa el recurso unordered-access-view (UAV) que se va a borrar.

Values

Tipo: [in] const UINT[4]

Matriz de 4 componentes que contiene los valores con los que rellenar el recurso unordered-access-view con.

NumRects

Tipo: [in] UINT

Número de rectángulos de la matriz que especifica el parámetro pRects .

pRects

Tipo: [in] const D3D12_RECT*

Matriz de estructuras de D3D12_RECT para los rectángulos de la vista de recursos que se van a borrar. Si es NULL, ClearUnorderedAccessViewUint borra toda la vista de recursos.

Valor devuelto

None

Observaciones

Validación en tiempo de ejecución

El error de validación da como resultado la llamada a ID3D12GraphicsCommandList::Close devolviendo E_INVALIDARG.

Capa de depuración

La capa de depuración emite errores si los valores de entrada están fuera de un intervalo normalizado.

La capa de depuración emite un error si los subrecursos a los que hace referencia la vista no están en el estado adecuado. Para ClearUnorderedAccessViewUint, el estado debe ser D3D12_RESOURCE_STATE_UNORDERED_ACCESS.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado d3d12.h
Library D3d12.lib
Archivo DLL D3d12.dll

Consulte también

Interfaz ID3D12GraphicsCommandList