estructura de KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT (wdm.h)
La estructura de KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT describe el contexto de notificación que se pasa a una función de devolución de llamada registrada cuando un nuevo procesador se agrega dinámicamente a una partición de hardware.
Sintaxis
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;
Miembros
State
Estado de la operación de adición del procesador. Los valores posibles son:
KeProcessorAddStartNotify
El sistema operativo está a punto de agregar el procesador. En este estado, un controlador de dispositivo que recibe esta notificación puede asignar cualquier estructura de datos por procesador y realizar cualquier otra tarea necesaria para preparar el controlador para su ejecución en el nuevo procesador.
KeProcessorAddCompleteNotify
El sistema operativo ha agregado correctamente el procesador. En este estado, un controlador de dispositivo que recibe esta notificación puede empezar a programar subprocesos en el nuevo procesador.
KeProcessorAddFailureNotify
El sistema operativo no pudo agregar el procesador. Si un controlador de dispositivo recibe esta notificación, debe liberar cualquier estructura de datos por procesador que haya asignado para el nuevo procesador cuando haya recibido la notificación KeProcessorAddStartNotify .
NtNumber
Índice de procesador del nuevo procesador. Para obtener información sobre la relación entre un índice de procesador y un número de procesador, vea KeGetProcessorNumberFromIndex.
Status
Si el miembro State contiene KeProcessorAddFailureNotify, este miembro contiene el estado de error que indica por qué se produjo un error en la operación de adición del procesador.
ProcNumber
Número de procesador del nuevo procesador. Este miembro es una estructura de PROCESSOR_NUMBER que especifica un número de grupo y un número de procesador relativo al grupo.
Comentarios
La estructura de KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT está disponible a partir de Windows Server 2008.
Un controlador de dispositivo se registra para recibir notificaciones cuando un nuevo procesador se agrega dinámicamente a la partición de hardware mediante una llamada a la función KeRegisterProcessorChangeCallback . Para obtener más información sobre el registro para esta notificación, consulte Registro para la notificación de controlador sincrónica.
Cuando se agrega dinámicamente un nuevo procesador a la partición de hardware, el sistema operativo llama a cada función de devolución de llamada registrada dos veces. El sistema operativo llama a cada función de devolución de llamada registrada la primera vez con el estado KeProcessorAddStartNotify y la segunda vez con el estado KeProcessorAddCompleteNotify o el estado KeProcessorAddFailureNotify .
Una función de devolución de llamada del controlador de dispositivo que recibe estas notificaciones no debe modificar el contenido de la estructura de KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Se admite a partir de Windows Server 2008. |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |