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