Skip to main content
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 dimensão x. Deve ser menor ou igual a D3D12_CS_DISPATCH_MAX_THREAD_GROUPS_PER_DIMENSION (65535). ThreadGroupCountY _In_
Tipo: UINT O número de grupos despachados na dimensão y. Deve ser menor ou igual a D3D12_CS_DISPATCH_MAX_THREAD_GROUPS_PER_DIMENSION (65535). ThreadGroupCountZ _In_
Tipo: UINT O número de grupos despachados na dimensão z. Deve ser menor ou igual a D3D12_CS_DISPATCH_MAX_THREAD_GROUPS_PER_DIMENSION (65535). No nível de recurso 10, o valor de ThreadGroupCountZ deve ser 1. Flags _In_
Tipo: D3D12XBOX_DISPATCH_FLAGS Sinalizadores para controlar esta operação, como uma combinação OR bit a bit de constantes de enumeração D3D12XBOX_DISPATCH_FLAGS.

​
Valor retornado

Tipo: void

​
Comentários

Use este método para especificar diretamente os parâmetros do iniciador de despacho. Se o sombreador estiver usando Ordered Append, você deverá definir D3D12XBOX_DISPATCH_FLAG_ENABLE_ORDERED_APPEND no despacho para evitar que a GPU trave. Você chama este método para executar comandos em um sombreador de computação. Dentro de um grupo de threads, um sombreador de computação pode ser executado em muitos threads em paralelo. Para indexar um thread específico dentro de um grupo de threads, use um vetor 3D especificado como (x,y,z). Para a ilustração a seguir, suponha que o grupo de threads tenha 50 threads e que o tamanho do grupo seja (5,5,2). Um único thread é identificado em um grupo de threads com 50 threads usando o vetor (4,1,1). Figura 1. Ilustração de um único thread dentro de um grupo de 50 threads Diagrama de um vetor para um único thread em um grupo de threads. A ilustração a seguir mostra a relação entre os parâmetros passados para Dispatch (ou DispatchX), Dispatch(5,3,2), os valores especificados no atributo numthreads, numthreads(10,8,3), e os valores passados para o sombreador de computação para os valores de sistema relacionados a threads: SV_GroupIndex, SV_DispatchThreadID, SV_GroupThreadID e SV_GroupID. Figura 2. A relação entre Dispatch (ou DispatchX), grupos de threads e threads Diagrama que mostra as relações entre os parâmetros fornecidos aos métodos Dispatch e DispatchX para contagens de grupos de threads e os grupos de threads individuais, e a relação entre um grupo de threads e seus threads individuais, para ilustrar como os vários valores de sistema relacionados a threads passados para o sombreador de computação são identificados. Esta é a versão específica do XBOX do método Dispatch. Para obter informações adicionais sobre a versão genérica do Direct3d 12 do método, consulte Dispatch.

​
Requisitos

Cabeçalho: d3d12_x.h Biblioteca: d3d12_x.lib Plataformas com suporte: família XBOX One

​
Confira também

ID3D12GraphicsCommandList
Last modified on October 6, 2026