Skip to main content
Describes dispatch parameters, for use by the compute shader.

Syntax

Members

ThreadGroupCountX
Type: UINT
The size, in thread groups, of the x-dimension of the thread-group grid. ThreadGroupCountY
Type: UINT
The size, in thread groups, of the y-dimension of the thread-group grid. ThreadGroupCountZ
Type: UINT
The size, in thread groups, of the z-dimension of the thread-group grid.

Remarks

The members of this structure serve the same purpose as the parameters of Dispatch. A compiled compute shader defines the set of instructions to execute per thread and the number of threads to run per group. The thread-group parameters indicate how many thread groups to execute. Each thread group contains the same number of threads, as defined by the compiled compute shader. The thread groups are organized in a three-dimensional grid. The total number of thread groups that the compiled compute shader executes is determined by the following calculation:
In particular, if any of the values in the thread-group parameters are 0, nothing will happen. The maximum size of any dimension is 65535.

Requirements

Header: d3d12_xs.h or d3d12_x.h
Library: d3d12_xs.lib or d3d12_x.lib
Supported Platforms: XBOX Series consoles and XBOX One family

See Also

Core Structures
Last modified on August 20, 2026