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

# D3D12XBOX_COMMAND_LIST_DESC (XBOX One 系列)

> 命令清單的描述，包括 XBOX 專屬擴充功能。

命令清單的描述，包括 XBOX 專屬擴充功能。

## 語法

```cpp theme={null}
typedef struct D3D12XBOX_COMMAND_LIST_DESC {  
    D3D12_COMMAND_LIST_TYPE Type;  
    D3D12XBOX_COMMAND_LIST_FLAGS Flags;  
    UINT NodeMask;  
    UINT ResourceBarrierBatchSize;  
} D3D12XBOX_COMMAND_LIST_DESC  
```

### 成員

*Type*\
類型: [D3D12\_COMMAND\_LIST\_TYPE](/zh-TW/reference/graphics/d3d12_x/enums/d3d12_command_list_type)

指定要建立的命令清單類型。

*Flags*\
類型: [D3D12XBOX\_COMMAND\_LIST\_FLAGS](/zh-TW/reference/graphics/d3d12_x/enums/d3d12xbox_command_list_flags)

指定控制命令清單作業的旗標。

*NodeMask*\
類型: UINT

針對單一 GPU 上的作業，請將此值設定為零。

*ResourceBarrierBatchSize*\
類型: UINT

指定在對命令清單進行個別 [ResourceBarrier](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12xboxdmacommandlist/methods/id3d12xboxdmacommandlist_resourcebarrier) 呼叫中提交批次資源屏障集合時所使用的大小。

## 備註

[CreateCommandListX](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_createcommandlistx) 會使用此結構。

如果呼叫中指定的屏障數目超過 *ResourceBarrierBatchSize* 中指定的大小，群組化所帶來的好處會降低效能，其情況類似於使用數目相當於 *NumBarriers* 或 *ResourceBarrierBatchSize* + 1 的多個 [ResourceBarrier](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12xboxdmacommandlist/methods/id3d12xboxdmacommandlist_resourcebarrier) 呼叫。較大的批次大小可減少或消除 **ResourceBarrier** 所產生的多餘同步作業，代價是為命令清單配置額外的記憶體。大小為 0 時，會為圖形命令清單選取預設批次大小 1024，為計算命令清單選取 512。

## 需求

**標頭:** d3d12\_x.h

**支援的平台:** XBOX One 系列

## 另請參閱

[d3d12\_x](/zh-TW/reference/graphics/d3d12_x/d3d12_x_members)


## Related topics

- [NDA 主題目錄 - Microsoft Learn 線上連結](/zh-TW/nda/nda-topic-directory.md)
- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [NDA 主题目录 - Microsoft Learn 在线链接](/zh-CN/nda/nda-topic-directory.md)
- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr/nda/nda-topic-directory.md)