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 ein neuer Prozessor dynamisch zu einer Hardwarepartition 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;
Angehörige
State
Der Zustand des Prozessor-Add-Vorgangs. Mögliche Werte sind wie folgt:
KeProcessorAddStartNotify
Das Betriebssystem ist dabei, den Prozessor hinzuzufügen. In diesem Zustand kann ein Gerätetreiber, der diese Benachrichtigung empfängt, alle Datenstrukturen pro Prozessor zuordnen und alle anderen erforderlichen Aufgaben ausführen, um den Treiber für die Ausführung auf den neuen Prozessor vorzubereiten.
KeProcessorAddCompleteNotify
Das Betriebssystem hat den Prozessor erfolgreich hinzugefügt. In diesem Zustand kann ein Gerätetreiber, der diese Benachrichtigung empfängt, die Planung von Threads auf dem neuen Prozessor starten.
KeProcessorAddFailureNotify
Das Betriebssystem konnte den Prozessor nicht hinzufügen. Wenn ein Gerätetreiber diese Benachrichtigung empfängt, sollte er alle Prozessordatenstrukturen freigeben, die ihm für den neuen Prozessor zugewiesen wurden, wenn 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 Member KeProcessorAddFailureNotifyenthält, enthält dieses Element den Fehlerstatus, der angibt, warum der Prozessor-Add-Vorgang fehlgeschlagen ist.
ProcNumber
Die Prozessornummer des neuen Prozessors. Dieses Mitglied ist eine PROCESSOR_NUMBER Struktur, die eine Gruppennummer und eine gruppenrelative Prozessornummer angibt.
Bemerkungen
Die KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT-Struktur ist ab Windows Server 2008 verfügbar.
Ein Gerätetreiber registriert sich für den Empfang von Benachrichtigungen, 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 zweimal jede registrierte Rückruffunktion auf. Das Betriebssystem ruft jede registrierte Rückruffunktion zum ersten Mal mit dem KeProcessorAddStartNotify Zustand auf, und das zweite Mal mit dem KeProcessorAddCompleteNotify Zustand oder dem KeProcessorAddFailureNotify Zustand.
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 |
|---|---|
| mindestens unterstützte Client- | Wird ab Windows Server 2008 unterstützt. |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
Siehe auch
KeGetProcessorNumberFromIndex-