KeQueryGroupAffinity, fonction (ntddk.h)
La routine KeQueryGroupAffinity retourne un masque d’affinité qui identifie les processeurs logiques actifs dans un groupe spécifié dans un système multiprocesseur.
Syntaxe
KAFFINITY KeQueryGroupAffinity(
[in] USHORT GroupNumber
);
Paramètres
[in] GroupNumber
Numéro de groupe. Si un système multiprocesseur contient n groupes, les groupes sont numérotés de 0 à n-1. Pour obtenir le nombre de groupes actifs dans le système, appelez la routine KeQueryActiveGroupCount.
Valeur de retour
KeQueryGroupAffinity retourne une valeur KAFFINITY qui identifie les processeurs logiques actifs dans le groupe spécifié. Si la valeur de paramètre GroupNumber n’est pas un numéro de groupe valide, la routine retourne zéro.
Remarques
Une routine associée, KeQueryActiveProcessors, retourne un masque d’affinité qui représente un ensemble de processeurs actifs, mais cette routine, contrairement à KeQueryGroupAffinity, n’accepte pas un numéro de groupe comme paramètre d’entrée. Dans Windows 7 et versions ultérieures du système d’exploitation Windows, KeQueryActiveProcessors retourne un masque d’affinité pour les processeurs actifs dans le groupe 0, qui est compatible avec le comportement de cette routine dans les versions antérieures de Windows qui ne prennent pas en charge les groupes. Ce comportement garantit que les pilotes existants qui appellent KeQueryActiveProcessors et qui n’utilisent aucune fonctionnalité orientée groupe ne s’exécutent correctement dans les systèmes multiprocesseurs qui ont deux groupes ou plus. Toutefois, les pilotes qui utilisent toutes les fonctionnalités orientées groupe dans Windows 7 et versions ultérieures du système d’exploitation Windows doivent appeler KeQueryGroupAffinity au lieu de KeQueryActiveProcessors.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows 7 et versions ultérieures de Windows. |
| plateforme cible | Universel |
| d’en-tête | ntddk.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | N’importe quel niveau |