Sintaxis
Parámetros
ViewGPUHandleInCurrentHeapTipo: 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 visible para el sombreador, que debe establecerse en la lista de comandos mediante SetDescriptorHeaps. ViewCPUHandle
Tipo: D3D12_CPU_DESCRIPTOR_HANDLE Un D3D12_CPU_DESCRIPTOR_HANDLE en un montón de descriptores no visible para el sombreador que hace referencia a un descriptor inicializado para la vista de acceso desordenado (UAV) que se va a borrar.
Este descriptor no debe estar en un montón de descriptores visible para el sombreador. Esto es para permitir que los controladores que implementan el borrado como una operación de hardware de función fija (en lugar de como un dispatch) lean de forma eficiente el descriptor, ya que los montones visibles para el sombreador pueden crearse en memoria WRITE_BACK (de forma similar a los tipos de montón D3D12_HEAP_TYPE_UPLOAD), y las lecturas de la CPU desde este tipo de memoria son prohibitivamente lentas.
Tipo: ID3D12Resource * Un puntero a la interfaz ID3D12Resource que representa el recurso de vista de acceso desordenado (UAV) que se va a borrar. Values
Tipo: const FLOAT * Una matriz de 4 componentes que contiene los valores con los que se va a rellenar el recurso de vista de acceso desordenado. NumRects
Tipo: UINT El número de rectángulos de la matriz que especifica el parámetro pRects. pRects
Tipo: const D3D12_RECT * Una matriz de estructuras D3D12_RECT para los rectángulos de la vista de recursos que se van a borrar. Si es NULL, ClearUnorderedAccessViewFloat borra toda la vista de recursos.
Valor devuelto
Tipo: void Ninguno.Comentarios
Validación en tiempo de ejecución
Para las entradas de punto flotante, el runtime establece los valores desnormalizados en 0 (a la vez que conserva los NAN). Si quiere borrar la UAV con un patrón de bits específico, considere la posibilidad de usar ID3D12GraphicsCommandList::ClearUnorderedAccessViewUint. Un error de validación hace que la llamada a ID3D12GraphicsCommandList::Close devuelva 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 ClearUnorderedAccessViewFloat, el estado debe ser D3D12_RESOURCE_STATE_UNORDERED_ACCESS.Requisitos
Encabezado: d3d12_xs.h o d3d12_x.hBiblioteca: d3d12_xs.lib o d3d12_x.lib
Plataformas compatibles: consolas XBOX Series y familia XBOX One