GetProcessAffinityMask, fonction (winbase.h)

Article
08/27/2023

Récupère le masque d’affinité de processus pour le processus spécifié et le masque d’affinité système pour le système.

Syntaxe

BOOL GetProcessAffinityMask(
  [in]  HANDLE     hProcess,
  [out] PDWORD_PTR lpProcessAffinityMask,
  [out] PDWORD_PTR lpSystemAffinityMask
);

Paramètres

[in] hProcess

Handle du processus dont le masque d’affinité est souhaité.

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.

Windows Server 2003 et Windows XP : Le handle doit disposer du droit d’accès PROCESS_QUERY_INFORMATION .

[out] lpProcessAffinityMask

Pointeur vers une variable qui reçoit le masque d’affinité pour le processus spécifié.

[out] lpSystemAffinityMask

Pointeur vers une variable qui reçoit le masque d’affinité pour le système.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro et la fonction définit les variables pointées par lpProcessAffinityMask et lpSystemAffinityMask sur les masques d’affinité appropriés.

Sur un système avec plus de 64 processeurs, si les threads du processus appelant se trouvent dans un groupe de processeurs unique, la fonction définit les variables pointées par lpProcessAffinityMask et lpSystemAffinityMask sur le masque d’affinité de processus et le masque de processeur des processeurs logiques actifs pour ce groupe. Si le processus appelant contient des threads dans plusieurs groupes, la fonction retourne zéro pour les deux masques d’affinité.

Si la fonction échoue, la valeur de retour est égale à zéro et les valeurs des variables pointées par lpProcessAffinityMask et lpSystemAffinityMask ne sont pas définies. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Un masque d’affinité de processus est un vecteur de bits dans lequel chaque bit représente les processeurs sur lesquels un processus est autorisé à s’exécuter. Un masque d’affinité système est un vecteur de bits dans lequel chaque bit représente les processeurs configurés dans un système.

Un masque d’affinité de processus est un sous-ensemble du masque d’affinité système. Un processus n’est autorisé à s’exécuter que sur les processeurs configurés dans un système. Par conséquent, le masque d’affinité de processus ne peut pas spécifier un 1 bit pour un processeur lorsque le masque d’affinité système spécifie un 0 bit pour ce processeur.

À 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. La fonction GetProcessAffinityMask définit lpProcessAffinityMask et lpSystemAffinityMask sur les masques de processus et de processeur système sur le groupe principal du processus. Si le processus avait explicitement défini l’affinité d’un ou plusieurs de ses threads en dehors du groupe principal du processus, la fonction retourne zéro pour les deux masques d’affinité. Si, toutefois, hHandle spécifie un handle pour le processus en cours, la fonction utilise toujours le groupe principal du thread appelant (qui par défaut est le même que le groupe principal du processus) afin de définir le lpProcessAffinityMask et lpSystemAffinityMask.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll