> ## 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.

# ClearUnorderedAccessViewUint

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

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

## Sintaxis

```cpp theme={null}
void ClearUnorderedAccessViewUint(
    D3D12_GPU_DESCRIPTOR_HANDLE ViewGPUHandleInCurrentHeap,
    D3D12_CPU_DESCRIPTOR_HANDLE ViewCPUHandle,
    ID3D12Resource  pResource,
    const UINT  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 UINT \*

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**, **ClearUnorderedAccessViewUint** borra toda la vista de recursos.

### Valor devuelto

Tipo: void

Ninguno.

## Comentarios

### Validación en tiempo de ejecución

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 **ClearUnorderedAccessViewUint**, 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)