KeQueryMaximumProcessorCount, fonction (ntddk.h)

  • Article

La routine KeQueryMaximumProcessorCount retourne le nombre maximal de processeurs.

Syntaxe

ULONG KeQueryMaximumProcessorCount();

Valeur de retour

KeQueryMaximumProcessorCount retourne le nombre maximal de processeurs sous la forme d’une valeur ULONG.

Remarques

La valeur retournée par la routine KeQueryMaximumProcessorCount ne change pas au moment de l’exécution.

Si votre code utilise un tableau de mémoires tampons, une mémoire tampon pour chaque processeur, vous devez décider d’avoir un tableau de taille statique basé sur KeQueryMaximumProcessorCount ou un tableau de taille dynamique basé sur KeQueryActiveProcessorCount.

Pour optimiser en fonction du nombre de processeurs, vous avez besoin d’une structure redimensionnable pour Windows Server 2008. Dans ce cas, utilisez KeQueryActiveProcessorCount.

Si vous n’optimisez pas et si les structures de données résultant de l’utilisation du nombre maximal de processeurs sont relativement petites, une structure redimensionnable n’est pas nécessaire. Dans ce cas, utilisez KeQueryMaximumProcessorCount pour déterminer la taille d’un tableau statique.

Windows 7 et versions ultérieures de Windows prennent en charge les groupes de processeurs. Les pilotes conçus pour gérer des informations sur les groupes de processeurs doivent utiliser la routine KeQueryMaximumProcessorCountEx , qui spécifie un groupe de processeurs, au lieu de KeQueryMaximumProcessorCount, ce qui n’est pas le cas. Toutefois, l’implémentation de KeQueryMaximumProcessorCount dans Windows 7 et les versions ultérieures de Windows fournit la compatibilité pour les pilotes qui ont été écrits pour des versions antérieures de Windows, qui ne prennent pas en charge les groupes de processeurs. Dans cette implémentation, KeQueryMaximumProcessorCount retourne le nombre maximal de processeurs logiques qui peuvent se trouver dans le groupe 0.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows Vista et les versions plus récentes de Windows.
Plateforme cible Universal
En-tête ntddk.h (include Wdm.h, Ntddk.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL N’importe quel niveau

Voir aussi

KeQueryActiveProcessorCount

KeQueryMaximumProcessorCountEx