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