> ## 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_DISPATCH_FLAGS (XBOX Series 主機)

> D3D12XBOX_DISPATCH_FLAGS (XBOX Series 主機) — 用於控制 ID3D12GraphicsCommandList.DispatchX 的旗標。適用於 XBOX 的 Direct3D 12 圖形參考。

用於控制 [ID3D12GraphicsCommandList.DispatchX](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_dispatchx) 的旗標。

## 語法

```cpp theme={null}
typedef enum D3D12XBOX_DISPATCH_FLAGS  : UINT  
{  
    D3D12XBOX_DISPATCH_FLAG_NONE = 0x00000000,  
    D3D12XBOX_DISPATCH_FLAG_FORCE_START_AT_000 = 0x00000004,  
    D3D12XBOX_DISPATCH_FLAG_ENABLE_ORDERED_APPEND = 0x00000008,  
    D3D12XBOX_DISPATCH_FLAG_ORDERED_APPEND_WAVEID_PER_THREADGROUP = 0x00000010,  
    D3D12XBOX_DISPATCH_FLAG_USE_THREAD_DIMENSIONS = 0x00000020,  
    D3D12XBOX_DISPATCH_FLAG_ENABLE_OUT_OF_ORDER = 0x00000040,  
    D3D12XBOX_DISPATCH_FLAG_DISABLE_VOLATILE_VECTOR_L1 = 0x00000080,  
    D3D12XBOX_DISPATCH_FLAG_DISABLE_VOLATILE_SCALAR_L1 = 0x00000200,  
    D3D12XBOX_DISPATCH_FLAG_INVALIDATE_VOLATILE_SCALAR_L1 = 0x00000400,  
    D3D12XBOX_DISPATCH_FLAG_INVALIDATE_VOLATILE_VECTOR_L1 = 0x00000800,  
    D3D12XBOX_DISPATCH_FLAG_W32 = 0x00008000,  
} D3D12XBOX_DISPATCH_FLAGS  
```

## 常數

| 常數 | 描述 |
| - | - |
| D3D12XBOX\_DISPATCH\_FLAG\_NONE | 無旗標。 |
| D3D12XBOX\_DISPATCH\_FLAG\_FORCE\_START\_AT\_000 | 若為 0，則採用 COMPUTE\_START\_X、COMPUTE\_START\_Y 和 COMPUTE\_START\_Z 各自的值。若為 1，則覆寫 COMPUTE\_START\_X、COMPUTE\_START\_Y 和 COMPUTE\_START\_Z，並將它們設為 0。 |
| D3D12XBOX\_DISPATCH\_FLAG\_ENABLE\_ORDERED\_APPEND | 若為 0，則不支援 Ordered Append。若為 1，則支援 Ordered Append。 |
| D3D12XBOX\_DISPATCH\_FLAG\_ORDERED\_APPEND\_WAVEID\_PER\_THREADGROUP | 若為 0，則支援每個 wave 的唯一 wave ID。若為 1，則支援每個 ThreadGroup 的唯一 wave ID。 |
| D3D12XBOX\_DISPATCH\_FLAG\_USE\_THREAD\_DIMENSIONS | 若為 1，則將 *ThreadGroupCount* 參數解譯為每個維度中要分派的執行緒總數。 |
| D3D12XBOX\_DISPATCH\_FLAG\_ENABLE\_OUT\_OF\_ORDER | 若為 0，SPI 中的所有 CS wave 都必須依序啟動。若為 1，SPI 中的 CS wave 可以不依順序啟動。此旗標只能用於非同步佇列 (如需詳細資訊，請參閱[備註](#remarks)) |
| D3D12XBOX\_DISPATCH\_FLAG\_DISABLE\_VOLATILE\_VECTOR\_L1 | 停用 volatile 向量 L1。 |
| D3D12XBOX\_DISPATCH\_FLAG\_DISABLE\_VOLATILE\_SCALAR\_L1 | 停用 volatile 純量 L1。 |
| D3D12XBOX\_DISPATCH\_FLAG\_INVALIDATE\_VOLATILE\_SCALAR\_L1 | 使所有標記為 volatile 的快取行純量 L1 失效。 |
| D3D12XBOX\_DISPATCH\_FLAG\_INVALIDATE\_VOLATILE\_VECTOR\_L1 | 使所有標記為 volatile 的快取行向量 L1 失效。 |
| D3D12XBOX\_DISPATCH\_FLAG\_W32 | 若設定此旗標，則啟用 wave 32 工作負載，否則預設為 wave 64。 |

## 備註

`D3D12XBOX_DISPATCH_FLAGS` 用於控制 [ID3D12GraphicsCommandList.DispatchX](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_dispatchx)。<br />這些列舉常數會以位元 OR 組合的方式傳入。

* 對於在 wave32 模式下僅包含單一 wave，且只宣告一個執行緒群組維度 (例如 `[numthreads(X, 1, 1)]`) 的執行緒群組，可以使用 `D3D12XBOX_DISPATCH_FLAG_ENABLE_OUT_OF_ORDER` 旗標，在 XBOX Series X 上達到每個時脈週期啟動 2 個 wave、在 XBOX Series S 上達到每個時脈週期啟動 1 個 wave 的啟動速率。如需詳細資訊，請參閱 [**GpuBench**](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/samples/gdk-console-samples) 範例的 *"LaunchRate(ACS)"* 基準測試。
* 只有在繫結的計算著色器是以 `-D__XBOX_ENABLE_WAVE32=1` 編譯時，才必須設定 `D3D12XBOX_DISPATCH_FLAG_W32` 旗標 (請參閱 [**XBOX 著色器編譯器定義**](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/tools-console/xbox-tools-and-apis/shadercompiler/dxc-xbox-defines)

如需 `ID3D12GraphicsCommandList::DispatchX` 方法之一般 Direct3d 12 版本的詳細資訊，請參閱 [Dispatch](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nf-d3d12-id3d12graphicscommandlist-dispatch)。

## 需求

**標頭：** d3d12\_xs.h **支援的平台：** XBOX Series 主機

## 另請參閱

[d3d12\_xs](/zh-TW/reference/graphics/d3d12_xs/d3d12_xs_members)


## Related topics

- [D3D12_DISPATCH_RAYS_DESC (XBOX Series consoles)](/reference/graphics/d3d12/structs/d3d12_dispatch_rays_desc_public.md)
- [D3D12_DISPATCH_RAYS_DESC (consolas XBOX Series)](/es/reference/graphics/d3d12/structs/d3d12_dispatch_rays_desc_public.md)
- [D3D12_DISPATCH_RAYS_DESC (XBOX Series 콘솔)](/ko/reference/graphics/d3d12/structs/d3d12_dispatch_rays_desc_public.md)
- [D3D12_DISPATCH_RAYS_DESC (XBOX Series 主机)](/zh-CN/reference/graphics/d3d12/structs/d3d12_dispatch_rays_desc_public.md)
- [D3D12_EXPORT_FLAGS (XBOX Series consoles)](/reference/graphics/d3d12/enums/d3d12_export_flags_public.md)