KeQueryActiveGroupCount, fonction (ntddk.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. 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	ntddk.h (inclure Ntddk.h, Wdm.h, Ntddk.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	N’importe quel niveau

Voir aussi

KeQueryActiveProcessorCountEx

KeQueryMaximumGroupCount