Función PsRegisterSystemAvailableCpusChangeNotification (wdm.h)

La función PsRegisterSystemAvailableCpusChangeNotification registra una devolución de llamada a la que se llamará cuando las CPU que están disponibles para el proceso del sistema se someten a un cambio.

Sintaxis

NTSTATUS PsRegisterSystemAvailableCpusChangeNotification(
  [in]           PS_AVAILABLE_CPUS_CHANGE_CALLBACK     *Callback,
  [in, optional] PVOID                                 Context,
  [in, optional] PULONG64                              ObservedSequenceNumber,
  [out]          PS_AVAILABLE_CPUS_CHANGE_REGISTRATION *RegistrationHandle
);

Parámetros

[in] Callback

Puntero a la función de devolución de llamada a la que se va a llamar. Este parámetro es de tipo PS_AVAILABLE_CPUS_CHANGE_CALLBACK.

[in, optional] Context

Proporciona un parámetro de contexto que se pasará a la función de devolución de llamada.

[in, optional] ObservedSequenceNumber

Puntero opcional al número de secuencia de CPU disponible más reciente observado por el autor de la llamada. Si el número de secuencia ha avanzado desde esa observación, se realizará inmediatamente una devolución de llamada.

[out] RegistrationHandle

Puntero a un búfer que, tras el éxito, recibe un identificador del registro de devolución de llamada (PS_AVAILABLE_CPUS_CHANGE_REGISTRATION).

Valor devuelto

PsRegisterSystemAvailableCpusChangeNotification devuelve uno de los siguientes valores NTSTATUS:

Observaciones

Se debe llamar a esta rutina en PASSIVE_LEVEL.

La devolución de llamada se invocará cada vez que cambie el conjunto de CPU disponibles para el proceso del sistema. Esto puede ocurrir debido a las operaciones de conexión activa de CPU u otros eventos del sistema que afectan a la disponibilidad general de la CPU.

Para anular el registro de la devolución de llamada, llame a PsUnregisterAvailableCpusChangeNotification con el identificador de registro devuelto por esta función.

Si se proporciona un valor de ObservedSequenceNumber y el número de secuencia actual ha avanzado más allá de él, la devolución de llamada se invocará inmediatamente después del registro.

Esta función supervisa los cambios de disponibilidad de cpu en todo el sistema, en lugar de los cambios específicos del proceso supervisados por PsRegisterProcessAvailableCpusChangeNotification.

Requisitos

Consulte también

PsUnregisterAvailableCpusChangeNotification

PsRegisterProcessAvailableCpusChangeNotification

PS_AVAILABLE_CPUS_CHANGE_CALLBACK