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

> Define todos os elementos de uma exibição de acesso não ordenado (UAV) com os valores inteiros especificados.

Define todos os elementos de uma exibição de acesso não ordenado (UAV) com os valores inteiros especificados.

## Sintaxe

```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

Um [D3D12\_GPU\_DESCRIPTOR\_HANDLE](/pt-BR/reference/graphics/d3d12/structs/d3d12_gpu_descriptor_handle_public) que referencia um descritor inicializado para a exibição de acesso não ordenado (UAV) a ser limpa. Esse descritor deve estar em um heap de descritores visível ao sombreador, que deve ser definido na lista de comandos por meio de [SetDescriptorHeaps](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_setdescriptorheaps_public).

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

Um [D3D12\_CPU\_DESCRIPTOR\_HANDLE](/pt-BR/reference/graphics/d3d12/structs/d3d12_cpu_descriptor_handle_public) em um heap de descritores não visível ao sombreador que referencia um descritor inicializado para a exibição de acesso não ordenado (UAV) a ser limpa.

<Info>
  Esse descritor não deve estar em um heap de descritores visível ao sombreador. Isso permite que drivers que implementam a limpeza como uma operação de hardware de função fixa (em vez de um dispatch) leiam o descritor com eficiência, pois heaps visíveis ao sombreador podem ser criados em memória **WRITE\_BACK** (semelhante aos tipos de heap **D3D12\_HEAP\_TYPE\_UPLOAD**), e leituras da CPU nesse tipo de memória são extremamente lentas.
</Info>

*pResource*\
Tipo: ID3D12Resource \*

Um ponteiro para a interface [ID3D12Resource](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12Resource/id3d12resource_xs) que representa o recurso de exibição de acesso não ordenado (UAV) a ser limpo.

*Values*\
Tipo: const UINT \*

Uma matriz de 4 componentes que contém os valores com os quais preencher o recurso de exibição de acesso não ordenado.

*NumRects*\
Tipo: UINT

O número de retângulos na matriz especificada pelo parâmetro *pRects*.

*pRects*\
Tipo: const D3D12\_RECT \*

Uma matriz de estruturas **D3D12\_RECT** para os retângulos na exibição de recurso a serem limpos. Se for **NULL**, **ClearUnorderedAccessViewUint** limpará toda a exibição de recurso.

### Valor retornado

Tipo: void

Nenhum.

## Comentários

### Validação do runtime

Uma falha de validação faz com que a chamada para [ID3D12GraphicsCommandList::Close](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_close_public) retorne **E\_INVALIDARG**.

### Camada de depuração

A camada de depuração emite erros se os valores de entrada estiverem fora de um intervalo normalizado.

A camada de depuração emite um erro se os sub-recursos referenciados pela exibição não estiverem no estado apropriado. Para **ClearUnorderedAccessViewUint**, o estado deve ser [D3D12\_RESOURCE\_STATE\_UNORDERED\_ACCESS](/pt-BR/reference/graphics/d3d12_x/enums/d3d12_resource_states).

## Requisitos

**Cabeçalho:** d3d12\_xs.h ou d3d12\_x.h\
**Biblioteca:** d3d12\_xs.lib ou d3d12\_x.lib\
**Plataformas com suporte**: consoles XBOX Series e família XBOX One

## Confira também

[Interface ID3D12GraphicsCommandList](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList/id3d12graphicscommandlist_xs)


## Related topics

- [ClearUnorderedAccessViewFloat](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_clearunorderedaccessviewfloat_public.md)
- [D3D12_GPU_DESCRIPTOR_HANDLE](/pt-BR/reference/graphics/d3d12/structs/d3d12_gpu_descriptor_handle_public.md)
- [D3D12_CPU_DESCRIPTOR_HANDLE](/pt-BR/reference/graphics/d3d12/structs/d3d12_cpu_descriptor_handle_public.md)
- [SetComputeRootUnorderedAccessView](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_setcomputerootunorderedaccessview_public.md)
- [SetGraphicsRootUnorderedAccessView](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_setgraphicsrootunorderedaccessview_public.md)