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

> 描述 CPU 描述元控制代碼。

描述 CPU 描述元控制代碼。

## 語法

```cpp theme={null}
typedef struct D3D12_CPU_DESCRIPTOR_HANDLE
{
    SIZE_T ptr;
} D3D12_CPU_DESCRIPTOR_HANDLE
```

### 成員

*ptr*\
類型：SIZE\_T

描述元的位址。

## 備註

此結構由下列方法傳回：

<ul>
  <li>
    [ID3D12DescriptorHeap::GetCPUDescriptorHandleForHeapStart](/zh-TW/reference/graphics/d3d12/interfaces/id3d12descriptorheap/methods/id3d12descriptorheap_getcpudescriptorhandleforheapstart_public)
  </li>
</ul>

此結構會傳入下列方法：

<ul>
  <li>
    [ID3D12Device::CopyDescriptors](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_copydescriptors_public)
  </li>

  <li>
    [ID3D12Device::CopyDescriptorsSimple](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_copydescriptorssimple_public)
  </li>

  <li>
    [ID3D12Device::CreateConstantBufferView](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createconstantbufferview_public)
  </li>

  <li>
    [ID3D12Device::CreateShaderResourceView](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createshaderresourceview_public)
  </li>

  <li>
    [ID3D12Device::CreateUnorderedAccessView](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createunorderedaccessview_public)
  </li>

  <li>
    [ID3D12Device::CreateRenderTargetView](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createrendertargetview_public)
  </li>

  <li>
    [ID3D12Device::CreateDepthStencilView](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createdepthstencilview_public)
  </li>

  <li>
    [ID3D12Device::CreateSampler](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createsampler_public)
  </li>

  <li>
    [ID3D12GraphicsCommandList::ClearDepthStencilView](/zh-TW/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_cleardepthstencilview_public)
  </li>

  <li>
    [ID3D12GraphicsCommandList::ClearRenderTargetView](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList/methods/id3d12graphicscommandlist_clearrendertargetview_xs)
  </li>

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

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

  <li>
    [ID3D12GraphicsCommandList::OMSetRenderTargets](/zh-TW/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_omsetrendertargets_public)
  </li>
</ul>

若要取得控制代碼遞增大小，請使用 [ID3D12Device.GetDescriptorHandleIncrementSize](/zh-TW/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\_CPU\_DESCRIPTOR\_HANDLE](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/cd3dx12-cpu-descriptor-handle)
[ID3D12Device.GetDescriptorHandleIncrementSize](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_getdescriptorhandleincrementsize_public)

[核心結構](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/direct3d-12-structures)


## Related topics

- [D3D12_RENDER_PASS_RENDER_TARGET_DESC](/zh-TW/reference/graphics/d3d12/structs/d3d12_render_pass_render_target_desc_public.md)
- [GetCPUDescriptorHandleForHeapStart](/zh-TW/reference/graphics/d3d12/interfaces/id3d12descriptorheap/methods/id3d12descriptorheap_getcpudescriptorhandleforheapstart_public.md)
- [CopyDescriptorsSimple](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_copydescriptorssimple_public.md)
- [CopyDescriptors](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_copydescriptors_public.md)
- [D3D12_RENDER_PASS_DEPTH_STENCIL_DESC](/zh-TW/reference/graphics/d3d12/structs/d3d12_render_pass_depth_stencil_desc_public.md)