GetThreadGroupAffinity, fonction (processtopologyapi.h)
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 vers le thread pour lequel l’affinité de groupe de processeurs est souhaitée.
Le handle doit disposer du 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 GROUP_AFFINITY qui reçoit l’affinité de groupe du thread.
Valeur de retour
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, processus et affinités de thread s’étendent sur 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 7 [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | processtopologyapi.h (include Windows.h) |
| bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |