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

# GetDescriptorX (XBOX Series 主機)

> GetDescriptorX (XBOX Series 主機) — 取得此 ID3D12PipelineState 的描述元，以便搭配 ID3D12GraphicsCommandList::ExecuteIndirect 使用。

取得此 **ID3D12PipelineState** 的描述元，以便搭配 [ExecuteIndirect](https://msdn.microsoft.com/library/windows/desktop/Dn903884\(v=VS.85\).aspx) 使用。

## 語法

```cpp theme={null}
void GetDescriptorX(  
         D3D12XBOX_DESCRIPTOR_PIPELINE_STATE* pDescriptor  
)  
```

### 參數

*pDescriptor*   \_Out\_\
類型：[D3D12XBOX\_DESCRIPTOR\_PIPELINE\_STATE\*](/zh-TW/reference/graphics/d3d12_x/structs/d3d12xbox_descriptor_pipeline_state)

描述元，以指向 [D3D12XBOX\_DESCRIPTOR\_PIPELINE\_STATE](/zh-TW/reference/graphics/d3d12_x/structs/d3d12xbox_descriptor_pipeline_state) 結構的指標表示。

### 傳回值

類型：void

## 備註

此方法可讓您查詢管線狀態描述元，以供 [ExecuteIndirect](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nf-d3d12-id3d12graphicscommandlist-executeindirect) 使用。描述元必須一律透過 **GetDescriptorX** 查詢，且必須在建立對應的管線狀態物件之後查詢；無法在管線狀態物件的不同存留期之間靜態保存描述元。

**ExecuteIndirect** 的實作有下列限制：

* 整個引數緩衝區 (包括因步幅而略過的任何 DWORD) 都必須進行串流。因此，[D3D12\_COMMAND\_SIGNATURE\_DESC](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/ns-d3d12-d3d12_command_signature_desc) 結構的 **ByteStride** 成員限制為 256。
* 命令處理器的引數空間有限。因此，**D3D12\_COMMAND\_SIGNATURE\_DESC** 結構的 **NumArgumentDescs** 成員限制為 16。
* 在 [D3D12\_INDIRECT\_ARGUMENT\_DESC](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/ns-d3d12-d3d12_indirect_argument_desc) 結構內的 **Constant** 結構中，**Constant.Num32BitValuesToSet** 不能是 16 或更大。

## 需求

**標頭：** d3d12\_xs.h

**程式庫：** d3d12\_xs.lib

**支援的平台：** XBOX Series 主機

## 另請參閱

[ID3D12PipelineState](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12pipelinestate/id3d12pipelinestate)


## Related topics

- [NDA 主題目錄 - Microsoft Learn 線上連結](/zh-TW/nda/nda-topic-directory.md)
- [XBOX Series X|S 總覽](/zh-TW/paths/series-xs/overview.md)
- [Play Anywhere(主機 + PC)總覽](/zh-TW/paths/play-anywhere/overview.md)
- [XBOX 主機遊戲的認證測試 XBOX 需求](/zh-TW/publishing/certification/console-cert-tested-requirements.md)
- [XR-130 XBOX Series X|S 世代](/zh-TW/publishing/certification/xr/xr-130.md)