KeQueryMaximumProcessorCount, fonction (ntddk.h)
La routine KeQueryMaximumProcessorCount retourne le nombre maximal de processeurs.
Syntaxe
ULONG KeQueryMaximumProcessorCount();
Valeur de retour
KeQueryMaximumProcessorCount retourne le nombre maximal de processeurs sous forme de 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 s’il faut disposer d’un tableau de taille statique en fonction de KeQueryMaximumProcessorCount ou d’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 groupes de processeurs de prise en charge de Windows. 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 ne le fait pas. Toutefois, l’implémentation de KeQueryMaximumProcessorCount dans Windows 7 et versions ultérieures de Windows fournit la compatibilité pour les pilotes écrits pour les 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 pouvant se trouver dans le groupe 0.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows Vista et versions ultérieures de Windows. |
| plateforme cible | Universel |
| d’en-tête | ntddk.h (include Wdm.h, Ntddk.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | N’importe quel niveau |