KeGetProcessorIndexFromNumber, fonction (wdm.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 PROCESSOR_NUMBER allouée par l’appelant qui contient un numéro de groupe et un numéro de processeur relatif au groupe.
Valeur de retour
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 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 numéros de processeur de chaque groupe sont compris entre 0 et 63, mais les index de processeur à l’échelle du système sont compris entre 0 et 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows 7 et versions ultérieures de Windows. |
| plateforme cible | Universel |
| d’en-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | N’importe quel niveau |