GetThreadGroupAffinity, fonction (processtopologyapi.h)

  • Article

Récupère l’affinité de groupe de processeurs du thread spécifié.

Syntaxe

BOOL GetThreadGroupAffinity(
  [in]  HANDLE          hThread,
  [out] PGROUP_AFFINITY GroupAffinity
);

Paramètres

[in] hThread

Handle pour le thread pour lequel l’affinité de groupe de processeurs est souhaitée.

Le handle doit avoir le droit d’accès THREAD_QUERY_INFORMATION ou THREAD_QUERY_LIMITED_INFORMATION. Pour plus d’informations, consultez Sécurité des threads et droits d’accès.

[out] GroupAffinity

Pointeur vers une structure de GROUP_AFFINITY pour recevoir l’affinité de groupe du thread.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, utilisez GetLastError.

Remarques

À compter de Windows 11 et Windows Server 2022, sur un système avec plus de 64 processeurs, les affinités de processus et de thread couvrent tous les processeurs du système, sur tous les groupes de processeurs, par défaut. La fonction GetThreadGroupAffinity récupère l’affinité de groupe sur le groupe principal du thread.

Pour compiler une application qui utilise cette fonction, définissez _WIN32_WINNT >= 0x0601. Pour plus d’informations, consultez Utilisation des en-têtes Windows.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête processtopologyapi.h (inclure Windows.h)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

GetProcessGroupAffinity

Groupes de processeurs