> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ClearUnorderedAccessViewFloat

> Establece todos los elementos de una vista de acceso desordenado en los valores float especificados.

Establece todos los elementos de una vista de acceso desordenado (UAV) en los valores float especificados.

## Sintaxis

```cpp theme={null}
void ClearUnorderedAccessViewFloat(
    D3D12_GPU_DESCRIPTOR_HANDLE ViewGPUHandleInCurrentHeap,
    D3D12_CPU_DESCRIPTOR_HANDLE ViewCPUHandle,
    ID3D12Resource  pResource,
    const FLOAT  Values,
    UINT NumRects,
    const D3D12_RECT  pRects
)
```

### Parámetros

*ViewGPUHandleInCurrentHeap*\
Tipo: D3D12\_GPU\_DESCRIPTOR\_HANDLE

Un [D3D12\_GPU\_DESCRIPTOR\_HANDLE](/reference/graphics/d3d12/structs/d3d12_gpu_descriptor_handle_public) 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](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_setdescriptorheaps_public).

*ViewCPUHandle*\
Tipo: D3D12\_CPU\_DESCRIPTOR\_HANDLE

Un [D3D12\_CPU\_DESCRIPTOR\_HANDLE](/reference/graphics/d3d12/structs/d3d12_cpu_descriptor_handle_public) 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.

<Info>
  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.
</Info>

*pResource*\
Tipo: ID3D12Resource \*

Un puntero a la interfaz [ID3D12Resource](/reference/graphics/d3d12_xs/interfaces/ID3D12Resource/id3d12resource_xs) 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](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_clearunorderedaccessviewuint_public).

Un error de validación hace que la llamada a [ID3D12GraphicsCommandList::Close](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_close_public) 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](/reference/graphics/d3d12_x/enums/d3d12_resource_states).

## Requisitos

**Encabezado:** d3d12\_xs.h o d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib o d3d12\_x.lib\
**Plataformas compatibles**: consolas XBOX Series y familia XBOX One

## Consulte también

[Interfaz ID3D12GraphicsCommandList](/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList/id3d12graphicscommandlist_xs)


## Related topics

- [D3D12_GPU_DESCRIPTOR_HANDLE](/es/reference/graphics/d3d12/structs/d3d12_gpu_descriptor_handle_public.md)
- [D3D12_CPU_DESCRIPTOR_HANDLE](/es/reference/graphics/d3d12/structs/d3d12_cpu_descriptor_handle_public.md)
- [ClearUnorderedAccessViewUint](/es/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_clearunorderedaccessviewuint_public.md)
- [D3D12_UNORDERED_ACCESS_VIEW_DESC](/es/reference/graphics/d3d12/structs/d3d12_unordered_access_view_desc_public.md)
- [SetComputeRootUnorderedAccessView](/es/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_setcomputerootunorderedaccessview_public.md)