KeGetProcessorIndexFromNumber-Funktion (ntifs.h)

Die KeGetProcessorIndexFromNumber-Routine konvertiert eine Gruppennummer und eine gruppenrelative Prozessornummer in einen systemweiten Prozessorindex.

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.

Hinweise

Diese Routine akzeptiert als Eingabe eine 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 Mehrprozessorsystem identifiziert.

Wenn ein Mehrprozessorsystem beispielsweise zwei Gruppen enthält und jede Gruppe 64 logische Prozessoren enthält, reichen die Prozessornummern in jeder Gruppe von 0 bis 63, aber die systemweiten Prozessorindizes liegen zwischen 0 und 127.

Um die Gesamtzahl der aktiven logischen Prozessoren im System abzurufen, rufen Sie die KeQueryActiveProcessorCountEx-Routine auf, und legen Sie den GroupNumber-Parameter dieser Routine auf ALL_PROCESSOR_GROUPS fest.

Die KeGetProcessorNumberFromIndex-Routine konvertiert einen systemweiten Prozessorindex in eine Gruppennummer und eine gruppenrelative Prozessornummer.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7
Zielplattform	Universell
Header	ntifs.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Beliebige Ebene

Weitere Informationen

KeGetProcessorNumberFromIndex

KeQueryActiveProcessorCountEx

PROCESSOR_NUMBER