KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT-Struktur (wdm.h)

Die KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT-Struktur beschreibt den Benachrichtigungskontext, der an eine registrierte Rückruffunktion übergeben wird, wenn einer Hardwarepartition dynamisch ein neuer Prozessor hinzugefügt wird.

Syntax

typedef struct _KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT {
  KE_PROCESSOR_CHANGE_NOTIFY_STATE State;
  ULONG                            NtNumber;
  NTSTATUS                         Status;
  PROCESSOR_NUMBER                 ProcNumber;
} KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT, *PKE_PROCESSOR_CHANGE_NOTIFY_CONTEXT;

Member

State

Der Status des Prozessor-Add-Vorgangs. Es sind folgende Werte möglich:

KeProcessorAddStartNotify

Das Betriebssystem ist dabei, den Prozessor hinzuzufügen. In diesem Zustand kann ein Gerätetreiber, der diese Benachrichtigung empfängt, alle datenbasierten Datenstrukturen pro Prozessor zuordnen und alle anderen erforderlichen Aufgaben ausführen, um den Treiber auf die Ausführung auf dem neuen Prozessor vorzubereiten.

KeProcessorAddCompleteNotify

Das Betriebssystem hat den Prozessor erfolgreich hinzugefügt. In diesem Zustand kann ein Gerätetreiber, der diese Benachrichtigung empfängt, mit der Planung von Threads für den neuen Prozessor beginnen.

KeProcessorAddFailureNotify

Das Betriebssystem konnte den Prozessor nicht hinzufügen. Wenn ein Gerätetreiber diese Benachrichtigung empfängt, sollte er alle Prozessordatenstrukturen freigeben, die er dem neuen Prozessor zugewiesen hat, als er die KeProcessorAddStartNotify-Benachrichtigung erhalten hat.

NtNumber

Der Prozessorindex des neuen Prozessors. Informationen zur Beziehung zwischen einem Prozessorindex und einer Prozessornummer finden Sie unter KeGetProcessorNumberFromIndex.

Status

Wenn das State-ElementKeProcessorAddFailureNotify enthält, enthält dieses Element den Fehler status, der angibt, warum der Prozessorzusatzvorgang fehlgeschlagen ist.

ProcNumber

Die Prozessornummer des neuen Prozessors. Dieses Element ist eine PROCESSOR_NUMBER-Struktur , die eine Gruppennummer und eine gruppenrelative Prozessornummer angibt.

Hinweise

Die KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT-Struktur ist ab Windows Server 2008 verfügbar.

Ein Gerätetreiber registriert sich, um eine Benachrichtigung zu erhalten, wenn der Hardwarepartition dynamisch ein neuer Prozessor hinzugefügt wird, indem die KeRegisterProcessorChangeCallback-Funktion aufgerufen wird. Weitere Informationen zum Registrieren für diese Benachrichtigung finden Sie unter Registrieren für synchrone Treiberbenachrichtigungen.

Wenn der Hardwarepartition dynamisch ein neuer Prozessor hinzugefügt wird, ruft das Betriebssystem jede registrierte Rückruffunktion zweimal auf. Das Betriebssystem ruft jede registrierte Rückruffunktion zum ersten Mal mit dem Status KeProcessorAddStartNotify und beim zweiten Mal mit dem Status KeProcessorAddCompleteNotify oder keProcessorAddFailureNotify auf.

Die Rückruffunktion eines Gerätetreibers, die diese Benachrichtigungen empfängt, darf den Inhalt der KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT-Struktur nicht ändern.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt ab Windows Server 2008.
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)

Weitere Informationen

KeGetProcessorNumberFromIndex

KeRegisterProcessorChangeCallback

PROCESSOR_NUMBER