GetProcessGroupAffinity, fonction (processtopologyapi.h)
Récupère l’affinité de groupe de processeur du processus spécifié.
Syntaxe
BOOL GetProcessGroupAffinity(
[in] HANDLE hProcess,
[in, out] PUSHORT GroupCount,
[out] PUSHORT GroupArray
);
Paramètres
[in] hProcess
Handle du processus.
Ce handle doit avoir le droit d’accès PROCESS_QUERY_INFORMATION ou PROCESS_QUERY_LIMITED_INFORMATION. Pour plus d’informations, consultez Traiter les droits de sécurité et d’accès.
[in, out] GroupCount
En entrée, spécifie le nombre d’éléments dans le tableau GroupArray . Sur la sortie, spécifie le nombre de groupes de processeurs écrits dans le tableau. Si le tableau est trop petit, la fonction échoue avec ERROR_INSUFFICIENT_BUFFER et définit le paramètre GroupCount sur le nombre d’éléments requis.
[out] GroupArray
Tableau de numéros de groupe de processeurs. Un numéro de groupe est inclus dans le tableau si un thread du processus est attribué à un processeur du groupe.
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.
Si la valeur d’erreur est ERROR_INSUFFICIENT_BUFFER, le paramètre GroupCount contient la taille de mémoire tampon requise en nombre d’éléments.
Remarques
À compter de Windows 11 et De Windows Server 2022, sur un système avec plus de 64 processeurs, les affinités de processus et de thread s’étendent par défaut à tous les processeurs du système, dans tous les groupes de processeurs.
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 sur Windows Server 2008 Windows Server 2008 R2) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |