Fonction KeGetProcessorIndexFromNumber (ntifs.h)

  • Article

La routine KeGetProcessorIndexFromNumber convertit un numéro de groupe et un numéro de processeur relatif au groupe en index de processeur à l’échelle du système.

Syntaxe

ULONG KeGetProcessorIndexFromNumber(
  [in] PPROCESSOR_NUMBER ProcNumber
);

Paramètres

[in] ProcNumber

Pointeur vers une structure de PROCESSOR_NUMBER allouée à l’appelant qui contient un numéro de groupe et un numéro de processeur relatif au groupe.

Valeur retournée

KeGetProcessorIndexFromNumber retourne un index de processeur à l’échelle du système si l’appel réussit. Si ProcNumber pointe vers une valeur de PROCESSOR_NUMBER non valide, la routine retourne INVALID_PROCESSOR_INDEX, qui est définie dans le fichier d’en-tête Wdm.h.

Remarques

Cette routine accepte comme entrée une structure de PROCESSOR_NUMBER qui identifie un processeur par son numéro de groupe et son numéro de processeur au sein du groupe. La valeur de retour est un index de processeur qui identifie le processeur sur l’ensemble du système multiprocesseur.

Par exemple, si un système multiprocesseur contient deux groupes et que chaque groupe contient 64 processeurs logiques, les nombres de processeurs de chaque groupe vont de 0 à 63, mais les index de processeur à l’échelle du système varient de 0 à 127.

Pour obtenir le nombre total de processeurs logiques actifs dans le système, appelez la routine KeQueryActiveProcessorCountEx et définissez le paramètre GroupNumber de cette routine sur ALL_PROCESSOR_GROUPS.

La routine KeGetProcessorNumberFromIndex convertit un index de processeur à l’échelle du système en un numéro de groupe et un numéro de processeur relatif au groupe.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7
Plateforme cible Universal
En-tête ntifs.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL N’importe quel niveau

Voir aussi

KeGetProcessorNumberFromIndex

KeQueryActiveProcessorCountEx

PROCESSOR_NUMBER