Fonction KeGetProcessorIndexFromNumber (ntifs.h)
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 |