estructura KE_PROCESSOR_CHANGE_NOTIFY_CONTEXT (wdm.h)
La estructura 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 los siguientes:
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 las estructuras de datos por procesador asignadas al nuevo procesador cuando recibió 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, consulte 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 PROCESSOR_NUMBER que especifica un número de grupo y un número de procesador relativo al grupo.
Observaciones
La estructura 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 llamando a la función KeRegisterProcessorChangeCallback. Para obtener más información sobre cómo registrarse para esta notificación, vea Registro para notificaciones de controladores sincrónicos.
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 KeProcessorAddStartNot ify 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 | Valor |
|---|---|
| cliente mínimo admitido | Se admite a partir de Windows Server 2008. |
| encabezado de | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |