KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT struttura (wdm.h)
La struttura KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT descrive il contesto di notifica passato a una funzione di callback registrata quando un nuovo processore viene aggiunto dinamicamente a una partizione hardware.
Sintassi
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;
Members
State
Stato dell'operazione di aggiunta del processore. I possibili valori sono i seguenti:
KeProcessorAddStartNotify
Il sistema operativo sta per aggiungere il processore. A questo stato, un driver di dispositivo che riceve questa notifica può allocare qualsiasi struttura di dati per processore ed eseguire qualsiasi altra attività necessaria per preparare il driver per l'esecuzione nel nuovo processore.
KeProcessorAddCompleteNotify
Il sistema operativo ha aggiunto correttamente il processore. A questo stato, un driver di dispositivo che riceve questa notifica può avviare la pianificazione dei thread nel nuovo processore.
KeProcessorAddFailureNotify
Il sistema operativo non è riuscito ad aggiungere il processore. Se un driver di dispositivo riceve questa notifica, deve liberare qualsiasi struttura di dati per processore allocata per il nuovo processore quando ha ricevuto la notifica KeProcessorAddStartNotify .
NtNumber
Indice del processore del nuovo processore. Per informazioni sulla relazione tra un indice del processore e un numero di processore, vedere KeGetProcessorNumberFromIndex.
Status
Se il membro di Stato contiene KeProcessorAddFailureNotify, questo membro contiene lo stato di errore che indica perché l'operazione di aggiunta del processore non è riuscita.
ProcNumber
Numero di processore del nuovo processore. Questo membro è una struttura PROCESSOR_NUMBER che specifica un numero di gruppo e un numero di processore relativo al gruppo.
Commenti
La struttura KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT è disponibile a partire da Windows Server 2008.
Un driver di dispositivo registra per ricevere una notifica quando un nuovo processore viene aggiunto dinamicamente alla partizione hardware chiamando la funzione KeRegisterProcessorChangeCallback . Per altre informazioni sulla registrazione per questa notifica, vedere Registrazione per la notifica del driver sincrona.
Quando un nuovo processore viene aggiunto dinamicamente alla partizione hardware, il sistema operativo chiama ogni funzione di callback registrata due volte. Il sistema operativo chiama ogni funzione di callback registrata la prima volta con lo stato KeProcessorAddStartNotify e la seconda volta con lo stato KeProcessorAddCompleteNotify o lo stato KeProcessorAddFailureNotify .
La funzione di callback di un driver di dispositivo che riceve queste notifiche non deve modificare il contenuto della struttura KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato a partire da Windows Server 2008. |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |