KeQueryActiveGroupCount, fonction (wdm.h)
La routine KeQueryActiveGroupCount retourne le nombre de groupes de processeurs actifs dans un système multiprocesseur.
Syntaxe
USHORT KeQueryActiveGroupCount();
Valeur de retour
KeQueryActiveGroupCount retourne le nombre de groupes actifs.
Remarques
Un groupe de processeurs est actif s’il contient un ou plusieurs processeurs logiques actifs.
Un processeur logique actif est un processeur logique que Windows a démarré et ajouté à un système multiprocesseur. Le terme processeur actif s’applique à un processeur disponible pour effectuer le travail de traitement, que le processeur effectue actuellement un travail de traitement ou qu’il soit inactif. Dans certains systèmes, le nombre de processeurs actifs peut rester inchangé entre le démarrage et l’arrêt du système. Dans d’autres systèmes, Windows peut ajouter dynamiquement des processeurs actifs pendant l’exécution du système. Windows ne supprime jamais les processeurs actifs d’un système.
Ainsi, le nombre de processeurs actifs dans un système multiprocesseur peut augmenter entre le démarrage et l’arrêt du système, mais ce nombre ne diminue jamais. De même, le nombre de groupes actifs dans le système peut augmenter si un processeur est ajouté dynamiquement à un groupe inactif pendant l’exécution du système. Le nombre de groupes actifs ne diminue jamais.
En revanche, la valeur retournée par KeQueryMaximumGroupCount reste constante pendant l’exécution. Cette valeur est le nombre maximal de groupes que le système peut avoir.
Appelez la routine KeQueryActiveProcessorCountEx pour déterminer le nombre de processeurs logiques actifs dans un groupe particulier.
Windows 7 est la première version de Windows à prendre en charge les groupes de processeurs. Dans Windows 7, seules les versions 64 bits de Windows prennent en charge plusieurs groupes ; Les versions 32 bits de Windows ne prennent en charge qu’un seul groupe. Si un système multiprocesseur exécute une version 64 bits de Windows et ne contient pas plus de 64 processeurs logiques, Windows affecte tous les processeurs au groupe 0. Un système multiprocesseur qui exécute une version 32 bits de Windows ne peut pas contenir plus de 32 processeurs.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 7. |
| Plateforme cible | Universal |
| En-tête | wdm.h (inclure Ntddk.h, Wdm.h, Ntddk.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | N’importe quel niveau |