KeGetProcessorIndexFromNumber-Funktion (wdm.h)
Die KeGetProcessorIndexFromNumber Routine wandelt eine Gruppennummer und eine gruppenrelative Prozessornummer in einen systemweiten Prozessorindex um.
Syntax
ULONG KeGetProcessorIndexFromNumber(
[in] PPROCESSOR_NUMBER ProcNumber
);
Parameter
[in] ProcNumber
Ein Zeiger auf eine vom Aufrufer zugewiesene PROCESSOR_NUMBER Struktur, die eine Gruppennummer und eine gruppenrelative Prozessornummer enthält.
Rückgabewert
KeGetProcessorIndexFromNumber gibt einen systemweiten Prozessorindex zurück, wenn der Aufruf erfolgreich ist. Wenn ProcNumber auf einen ungültigen PROCESSOR_NUMBER-Wert verweist, gibt die Routine INVALID_PROCESSOR_INDEX zurück, die in der Wdm.h-Headerdatei definiert ist.
Bemerkungen
Diese Routine akzeptiert als Eingabe einer PROCESSOR_NUMBER Struktur, die einen Prozessor anhand seiner Gruppennummer und seiner Prozessornummer innerhalb der Gruppe identifiziert. Der Rückgabewert ist ein Prozessorindex, der den Prozessor im gesamten Multiprozessorsystem identifiziert.
Wenn z. B. ein Multiprozessorsystem zwei Gruppen enthält und jede Gruppe 64 logische Prozessoren enthält, liegen die Prozessornummern in jeder Gruppe zwischen 0 und 63, aber die systemweiten Prozessorindizes reichen von 0 bis 127.
Rufen Sie zum Abrufen der Gesamtzahl der aktiven logischen Prozessoren im System die KeQueryActiveProcessorCountEx Routine auf, und legen Sie den GroupNumber-Parameter dieser Routine auf ALL_PROCESSOR_GROUPS fest.
Die KeGetProcessorNumberFromIndex Routine wandelt einen systemweiten Prozessorindex in eine Gruppennummer und eine gruppenrelative Prozessornummer um.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 7 und höheren Versionen von Windows. |
| Zielplattform- | Universal |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | Beliebige Ebene |