KeGetProcessorIndexFromNumber-Funktion (wdm.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 zeigt, 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 Multiprozessorsystem identifiziert.

Wenn beispielsweise 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 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)	Verfügbar in Windows 7 und späteren Windows-Versionen.
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Beliebige Ebene

Weitere Informationen

KeGetProcessorNumberFromIndex

KeQueryActiveProcessorCountEx

PROCESSOR_NUMBER