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)

Consulte también

KeGetProcessorNumberFromIndex

KeRegisterProcessorChangeCallback

PROCESSOR_NUMBER