Función PsRegisterProcessAvailableCpusChangeNotification (wdm.h)

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

Sintaxis

NTSTATUS PsRegisterProcessAvailableCpusChangeNotification(
  [in]           PEPROCESS                             Process,
  [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] Process

Puntero a un proceso (PEPROCESS).

[in] Callback

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

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

[in, optional] ObservedSequenceNumber

Opcionalmente, proporciona un puntero 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

Proporciona un 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

PsRegisterProcessAvailableCpusChangeNotification 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 especificado. Esto puede ocurrir debido a operaciones de conexión activa de CPU, cambios de afinidad de proceso u otros eventos del sistema.

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.

Requisitos

Consulte también

PsUnregisterAvailableCpusChangeNotification

PsRegisterSystemAvailableCpusChangeNotification

PS_AVAILABLE_CPUS_CHANGE_CALLBACK