Skip to main content
Exécute une liste de commandes à partir d’un groupe de threads.

​
Syntaxe

​
Paramètres

ThreadGroupCountX _In_
Type : UINT Nombre de groupes distribués dans la dimension x. Doit être inférieur ou égal à D3D12_CS_DISPATCH_MAX_THREAD_GROUPS_PER_DIMENSION (65535). ThreadGroupCountY _In_
Type : UINT Nombre de groupes distribués dans la dimension y. Doit être inférieur ou égal à D3D12_CS_DISPATCH_MAX_THREAD_GROUPS_PER_DIMENSION (65535). ThreadGroupCountZ _In_
Type : UINT Nombre de groupes distribués dans la dimension z. Doit être inférieur ou égal à D3D12_CS_DISPATCH_MAX_THREAD_GROUPS_PER_DIMENSION (65535). Au niveau de fonctionnalité 10, la valeur de ThreadGroupCountZ doit être 1. Flags _In_
Type : D3D12XBOX_DISPATCH_FLAGS Indicateurs de contrôle de cette opération, sous forme de combinaison par OU au niveau du bit de constantes d’énumération D3D12XBOX_DISPATCH_FLAGS.

​
Valeur de retour

Type : void

​
Remarques

Utilisez cette méthode pour spécifier directement les paramètres de l’initiateur de distribution. Si le nuanceur utilise Ordered Append, vous devez définir D3D12XBOX_DISPATCH_FLAG_ENABLE_ORDERED_APPEND sur la distribution pour éviter de bloquer le GPU. Vous appelez cette méthode pour exécuter des commandes dans un nuanceur de calcul. Au sein d’un groupe de threads, un nuanceur de calcul peut s’exécuter sur de nombreux threads en parallèle. Pour indexer un thread précis au sein d’un groupe de threads, utilisez un vecteur 3D spécifié sous la forme (x,y,z). Pour l’illustration suivante, supposons que le groupe de threads compte 50 threads et que sa taille est (5,5,2). Un thread unique est identifié dans un groupe de 50 threads à l’aide du vecteur (4,1,1). Figure 1. Illustration d’un thread unique au sein d’un groupe de 50 threads Diagramme d'un vecteur pour un thread unique dans un groupe de threads. L’illustration suivante montre la relation entre les paramètres passés à Dispatch (ou DispatchX), Dispatch(5,3,2), les valeurs spécifiées dans l’attribut numthreads, numthreads(10,8,3), et les valeurs passées au nuanceur de calcul pour les valeurs système liées aux threads : SV_GroupIndex, SV_DispatchThreadID, SV_GroupThreadID et SV_GroupID. Figure 2. Relation entre Dispatch (ou DispatchX), les groupes de threads et les threads Diagramme qui montre les relations entre les paramètres fournis aux méthodes Dispatch et DispatchX pour le nombre de groupes de threads et les groupes de threads individuels, ainsi que la relation entre un groupe de threads et ses threads individuels, afin d'illustrer la façon dont les diverses valeurs système liées aux threads passées au nuanceur de calcul sont identifiées. Il s’agit de la version propre à XBOX de la méthode Dispatch. Pour plus d’informations sur la version générique Direct3d 12 de la méthode, consultez Dispatch.

​
Configuration requise

En-tête : d3d12_x.h Bibliothèque : d3d12_x.lib Plateformes prises en charge : famille XBOX One

​
Voir aussi

ID3D12GraphicsCommandList
Last modified on October 6, 2026