Compartilhar via


Método ID3D11DeviceContext::D ispatch (d3d11.h)

Execute uma lista de comandos de um grupo de threads.

Sintaxe

void Dispatch(
  [in] UINT ThreadGroupCountX,
  [in] UINT ThreadGroupCountY,
  [in] UINT ThreadGroupCountZ
);

Parâmetros

[in] ThreadGroupCountX

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).

[in] ThreadGroupCountY

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).

[in] ThreadGroupCountZ

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.

Retornar valor

Nenhum

Comentários

Você chama o método Dispatch para executar comandos em um sombreador de computação. Um sombreador de computação pode ser executado em muitos 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).

Na ilustração a seguir, suponha um grupo de threads com 50 threads em que o tamanho do grupo é fornecido por (5,5,2). Um único thread é identificado de um grupo de threads com 50 threads, usando o vetor (4,1,1).

Ilustração de um único thread dentro de um grupo de threads de 50 threads

A ilustração a seguir mostra a relação entre os parâmetros passados para ID3D11DeviceContext::D ispatch, Dispatch(5,3,2), os valores especificados no atributo numthreads, numthreads(10,8,3) e valores que serão passados para o sombreador de computação para os valores do sistema relacionados ao thread (SV_GroupIndex,SV_DispatchThreadID,SV_GroupThreadID,SV_GroupID).

Ilustração da relação entre Dispatch, grupos de threads e threads

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho d3d11.h
Biblioteca D3D11.lib

Confira também

ID3D11DeviceContext