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

# D3D12_GPU_DESCRIPTOR_HANDLE

> GPU 디스크립터 핸들을 설명합니다.

GPU 디스크립터 핸들을 설명합니다.

## 구문

```cpp theme={null}
typedef struct D3D12_GPU_DESCRIPTOR_HANDLE
{
    UINT64 ptr;
} D3D12_GPU_DESCRIPTOR_HANDLE
```

### 멤버

*ptr*\
형식: UINT64

디스크립터의 주소입니다.

## 설명

이 구조체는 [ID3D12DescriptorHeap::GetGPUDescriptorHandleForHeapStart](/reference/graphics/d3d12/interfaces/id3d12descriptorheap/methods/id3d12descriptorheap_getgpudescriptorhandleforheapstart_public)에서 반환됩니다.

이 구조체는 다음 메서드에 전달됩니다.

<ul>
  <li>
    [ID3D12GraphicsCommandList::ClearUnorderedAccessViewFloat](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_clearunorderedaccessviewfloat_public)
  </li>

  <li>
    [ID3D12GraphicsCommandList::ClearUnorderedAccessViewUint](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_clearunorderedaccessviewuint_public)
  </li>

  <li>
    [ID3D12GraphicsCommandList:SetComputeRootDescriptorTable](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_setcomputerootdescriptortable_public)
  </li>

  <li>
    [ID3D12GraphicsCommandList::SetGraphicsRootDescriptorTable](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_setgraphicsrootdescriptortable_public)
  </li>
</ul>

핸들 증분 크기를 얻으려면 [ID3D12Device.GetDescriptorHandleIncrementSize](/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_getdescriptorhandleincrementsize_public)를 사용하세요.

## 요구 사항

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

## 함께 보기

[CD3DX12\_GPU\_DESCRIPTOR\_HANDLE](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/cd3dx12-gpu-descriptor-handle)
[ID3D12Device.GetDescriptorHandleIncrementSize](/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_getdescriptorhandleincrementsize_public)

[핵심 구조체](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/direct3d-12-structures)


## Related topics

- [GetGPUDescriptorHandleForHeapStart](/ko/reference/graphics/d3d12/interfaces/id3d12descriptorheap/methods/id3d12descriptorheap_getgpudescriptorhandleforheapstart_public.md)
- [SetGraphicsRootDescriptorTable](/ko/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_setgraphicsrootdescriptortable_public.md)
- [SetComputeRootDescriptorTable](/ko/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_setcomputerootdescriptortable_public.md)
- [ClearUnorderedAccessViewFloat](/ko/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_clearunorderedaccessviewfloat_public.md)
- [ClearUnorderedAccessViewUint](/ko/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_clearunorderedaccessviewuint_public.md)