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

> 정렬되지 않은 액세스 뷰(UAV)의 모든 요소를 지정된 정수 값으로 설정합니다.

정렬되지 않은 액세스 뷰(UAV)의 모든 요소를 지정된 정수 값으로 설정합니다.

## 구문

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

### 매개 변수

*ViewGPUHandleInCurrentHeap*\
형식: D3D12\_GPU\_DESCRIPTOR\_HANDLE

지울 정렬되지 않은 액세스 뷰(UAV)에 대한 초기화된 디스크립터를 참조하는 [D3D12\_GPU\_DESCRIPTOR\_HANDLE](/reference/graphics/d3d12/structs/d3d12_gpu_descriptor_handle_public)입니다. 이 디스크립터는 셰이더 표시 디스크립터 힙에 있어야 하며, 이 힙은 [SetDescriptorHeaps](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_setdescriptorheaps_public)를 통해 명령 목록에 설정되어야 합니다.

*ViewCPUHandle*\
형식: D3D12\_CPU\_DESCRIPTOR\_HANDLE

지울 정렬되지 않은 액세스 뷰(UAV)에 대한 초기화된 디스크립터를 참조하는 비셰이더 표시 디스크립터 힙의 [D3D12\_CPU\_DESCRIPTOR\_HANDLE](/reference/graphics/d3d12/structs/d3d12_cpu_descriptor_handle_public)입니다.

<Info>
  이 디스크립터는 셰이더 표시 디스크립터 힙에 있어서는 안 됩니다. 이는 셰이더 표시 힙이 **WRITE\_BACK** 메모리(**D3D12\_HEAP\_TYPE\_UPLOAD** 힙 유형과 유사)에서 생성될 수 있고 이 유형의 메모리에서 CPU 읽기는 매우 느리므로, 클리어를 (디스패치가 아닌) 고정 함수 하드웨어 작업으로 구현하는 드라이버가 디스크립터에서 효율적으로 읽을 수 있도록 하기 위함입니다.
</Info>

*pResource*\
형식: ID3D12Resource \*

지울 정렬되지 않은 액세스 뷰(UAV) 리소스를 나타내는 [ID3D12Resource](/reference/graphics/d3d12_xs/interfaces/ID3D12Resource/id3d12resource_xs) 인터페이스에 대한 포인터입니다.

*Values*\
형식: const UINT \*

정렬되지 않은 액세스 뷰 리소스를 채울 값이 포함된 4개 구성 요소 배열입니다.

*NumRects*\
형식: UINT

*pRects* 매개 변수가 지정하는 배열의 사각형 수입니다.

*pRects*\
형식: const D3D12\_RECT \*

지울 리소스 뷰의 사각형에 대한 **D3D12\_RECT** 구조체 배열입니다. **NULL**이면 **ClearUnorderedAccessViewUint**는 전체 리소스 뷰를 지웁니다.

### 반환 값

형식: void

없음.

## 설명

### 런타임 유효성 검사

유효성 검사에 실패하면 [ID3D12GraphicsCommandList::Close](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_close_public) 호출이 **E\_INVALIDARG**를 반환합니다.

### 디버그 레이어

입력 값이 정규화된 범위를 벗어나는 경우 디버그 레이어는 오류를 발생시킵니다.

뷰가 참조하는 하위 리소스가 적절한 상태가 아닌 경우 디버그 레이어는 오류를 발생시킵니다. **ClearUnorderedAccessViewUint**의 경우 상태는 [D3D12\_RESOURCE\_STATE\_UNORDERED\_ACCESS](/reference/graphics/d3d12_x/enums/d3d12_resource_states)여야 합니다.

## 요구 사항

**헤더:** d3d12\_xs.h 또는 d3d12\_x.h\
**라이브러리:** d3d12\_xs.lib 또는 d3d12\_x.lib\
**지원 플랫폼**: XBOX Series 콘솔 및 XBOX One 제품군

## 함께 보기

[ID3D12GraphicsCommandList 인터페이스](/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList/id3d12graphicscommandlist_xs)


## Related topics

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