Partager via


ID3D11DeviceContext ::D ispatch, méthode (d3d11.h)

Exécutez une liste de commandes à partir d’un groupe de threads.

Syntaxe

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

Paramètres

[in] ThreadGroupCountX

Type : UINT

Nombre de groupes distribués dans la direction x. ThreadGroupCountX doit être inférieur ou égal à D3D11_CS_DISPATCH_MAX_THREAD_GROUPS_PER_DIMENSION (65535).

[in] ThreadGroupCountY

Type : UINT

Nombre de groupes distribués dans la direction y. ThreadGroupCountY doit être inférieur ou égal à D3D11_CS_DISPATCH_MAX_THREAD_GROUPS_PER_DIMENSION (65535).

[in] ThreadGroupCountZ

Type : UINT

Nombre de groupes distribués dans la direction z. ThreadGroupCountZ doit être inférieur ou égal à D3D11_CS_DISPATCH_MAX_THREAD_GROUPS_PER_DIMENSION (65535). Au niveau de fonctionnalité 10, la valeur de ThreadGroupCountZ doit être 1.

Valeur de retour

None

Remarques

Vous appelez la méthode Dispatch pour exécuter des commandes dans un nuanceur de calcul. Un nuanceur de calcul peut être exécuté sur de nombreux threads en parallèle, au sein d’un groupe de threads. Indexer un thread particulier, dans un groupe de threads à l’aide d’un vecteur 3D donné par (x,y,z).

Dans l’illustration suivante, supposons un groupe de threads avec 50 threads où la taille du groupe est donnée par (5,5,2). Un thread unique est identifié à partir d’un groupe de threads contenant 50 threads, à l’aide du vecteur (4,1,1).

Illustration d’un thread unique dans un groupe de threads de 50 threads

L’illustration suivante montre la relation entre les paramètres passés à ID3D11DeviceContext ::D ispatch, Dispatch(5,3,2), les valeurs spécifiées dans l’attribut numthreads, numthreads(10,8,3) et les valeurs qui seront transmises au nuanceur de calcul pour les valeurs système liées aux threads (SV_GroupIndex,SV_DispatchThreadID,SV_GroupThreadID,SV_GroupID).

Illustration de la relation entre Dispatch, les groupes de threads et les threads

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête d3d11.h
Bibliothèque D3D11.lib

Voir aussi

ID3D11DeviceContext