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) |