Skip to main content
從執行緒群組執行命令清單。

​
語法

​
參數

ThreadGroupCountX _In_
類型：UINT 在 x 維度中分派的群組數目。必須小於或等於 D3D12_CS_DISPATCH_MAX_THREAD_GROUPS_PER_DIMENSION (65535)。 ThreadGroupCountY _In_
類型：UINT 在 y 維度中分派的群組數目。必須小於或等於 D3D12_CS_DISPATCH_MAX_THREAD_GROUPS_PER_DIMENSION (65535)。 ThreadGroupCountZ _In_
類型：UINT 在 z 維度中分派的群組數目。必須小於或等於 D3D12_CS_DISPATCH_MAX_THREAD_GROUPS_PER_DIMENSION (65535)。在功能層級 10 中，ThreadGroupCountZ 的值必須為 1。 Flags _In_
類型：D3D12XBOX_DISPATCH_FLAGS 用來控制此作業的旗標，為 D3D12XBOX_DISPATCH_FLAGS 列舉常數的位元 OR 組合。

​
傳回值

類型：void

​
備註

使用此方法可直接指定分派起始器參數。如果著色器使用 Ordered Append，您必須在分派上設定 D3D12XBOX_DISPATCH_FLAG_ENABLE_ORDERED_APPEND，以避免造成 GPU 停止回應。 呼叫此方法可在計算著色器中執行命令。在執行緒群組內，計算著色器可以在許多執行緒上平行執行。若要索引執行緒群組內的特定執行緒，請使用指定為 (x,y,z) 的 3D 向量。 在下圖中，假設執行緒群組有 50 個執行緒，且群組的大小為 (5,5,2)。使用向量 (4,1,1) 從包含 50 個執行緒的執行緒群組中識別單一執行緒。 圖 1. 50 個執行緒之執行緒群組內單一執行緒的圖例 執行緒群組中單一執行緒之向量的圖表。 下圖顯示傳遞給 Dispatch (或 DispatchX) 的參數 Dispatch(5,3,2)、numthreads 屬性中指定的值 numthreads(10,8,3)，以及針對執行緒相關系統值 SV_GroupIndex、SV_DispatchThreadID、SV_GroupThreadID 和 SV_GroupID 傳遞給計算著色器的值之間的關係。 圖 2. Dispatch (或 DispatchX)、執行緒群組與執行緒之間的關係 此圖表顯示提供給 Dispatch 和 DispatchX 方法的執行緒群組計數參數與個別執行緒群組之間的關係，以及執行緒群組與其個別執行緒之間的關係，用以說明如何識別傳遞給計算著色器的各種執行緒相關系統值。 這是 Dispatch 方法的 XBOX 特定版本。如需此方法之一般 Direct3d 12 版本的其他資訊，請參閱 Dispatch。

​
需求

標頭: d3d12_x.h 程式庫: d3d12_x.lib 支援的平台: XBOX One 系列

​
另請參閱

ID3D12GraphicsCommandList
Last modified on October 6, 2026