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

> 描述分派參數，供計算著色器使用。

描述分派參數，供計算著色器使用。

## 語法

```cpp theme={null}
typedef struct D3D12_DISPATCH_ARGUMENTS
{
    UINT ThreadGroupCountX;
    UINT ThreadGroupCountY;
    UINT ThreadGroupCountZ;
} D3D12_DISPATCH_ARGUMENTS
```

### 成員

*ThreadGroupCountX*\
類型：UINT

執行緒群組格線 x 維度的大小 (以執行緒群組為單位)。

*ThreadGroupCountY*\
類型：UINT

執行緒群組格線 y 維度的大小 (以執行緒群組為單位)。

*ThreadGroupCountZ*\
類型：UINT

執行緒群組格線 z 維度的大小 (以執行緒群組為單位)。

## 備註

此結構的成員與 [Dispatch](/zh-TW/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_dispatch_public) 的參數具有相同用途。

已編譯的計算著色器會定義每個執行緒要執行的指令集，以及每個群組要執行的執行緒數目。執行緒群組參數表示要執行多少個執行緒群組。每個執行緒群組都包含相同數目的執行緒，如已編譯的計算著色器所定義。執行緒群組會組織成三維格線。已編譯的計算著色器執行的執行緒群組總數由下列計算決定：

```syntax theme={null}
ThreadGroupCountX * ThreadGroupCountY * ThreadGroupCountZ
```

特別是，如果執行緒群組參數中有任何值為 0，則不會發生任何動作。

任何維度的大小上限為 65535。

## 需求

**標頭:** d3d12\_xs.h 或 d3d12\_x.h\
**程式庫:** d3d12\_xs.lib 或 d3d12\_x.lib\
**支援的平台**: XBOX Series 主機與 XBOX One 系列

## 另請參閱

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


## Related topics

- [D3D12_DRAW_ARGUMENTS](/zh-TW/reference/graphics/d3d12/structs/d3d12_draw_arguments_public.md)
- [D3D12_DRAW_INDEXED_ARGUMENTS](/zh-TW/reference/graphics/d3d12/structs/d3d12_draw_indexed_arguments_public.md)
- [D3D12_DISPATCH_RAYS_DESC (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/structs/d3d12_dispatch_rays_desc_public.md)
- [D3D12_COMMAND_SIGNATURE_DESC](/zh-TW/reference/graphics/d3d12/structs/d3d12_command_signature_desc_public.md)
- [D3D12_AUTO_BREADCRUMB_OP](/zh-TW/reference/graphics/d3d12/enums/d3d12_auto_breadcrumb_op_public.md)
