Pular para o conteúdo principal
Executa uma lista de comandos a partir de um grupo de threads.

Sintaxe

Parâmetros

ThreadGroupCountX [in]
Tipo: UINT
O número de grupos despachados na direção x. ThreadGroupCountX deve ser menor ou igual a D3D11_CS_DISPATCH_MAX_THREAD_GROUPS_PER_DIMENSION (65535). ThreadGroupCountY [in]
Tipo: UINT
O número de grupos despachados na direção y. ThreadGroupCountY deve ser menor ou igual a D3D11_CS_DISPATCH_MAX_THREAD_GROUPS_PER_DIMENSION (65535). ThreadGroupCountZ [in]
Tipo: UINT
O número de grupos despachados na direção z. ThreadGroupCountZ deve ser menor ou igual a D3D11_CS_DISPATCH_MAX_THREAD_GROUPS_PER_DIMENSION (65535). No nível de recurso 10, o valor de ThreadGroupCountZ deve ser 1.

Valor retornado

Tipo: void Nenhum.

Comentários

Chame o método Dispatch para executar comandos em um sombreador de computação. Um sombreador de computação pode ser executado em vários threads em paralelo, dentro de um grupo de threads. Indexe um thread específico dentro de um grupo de threads usando um vetor 3D fornecido por (x,y,z).

Exemplos

O exemplo D3D12nBodyGravity usa ID3D12GraphicsCommandList::Dispatch da seguinte maneira:
Consulte o Código de exemplo na referência do D3D12.

Requisitos

Cabeçalho: d3d12_xs.h ou d3d12_x.h
Biblioteca: d3d12_xs.lib ou d3d12_x.lib
Plataformas com suporte: consoles XBOX Series e família XBOX One

Confira também

ID3D12GraphicsCommandList
Última modificação em 6 de outubro de 2026