GetProcessGroupAffinity, fonction (processtopologyapi.h)

  • Article

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

Voir aussi

GetThreadGroupAffinity

Groupes de processeurs