PsRegisterProcessAvailableCpusChangeNotification, fonction (wdm.h)

La fonction PsRegisterProcessAvailableCpusChangeNotification inscrit un rappel à appeler lorsque les PROCESSEURs disponibles pour un processus subissent une modification.

Syntaxe

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
);

Paramètres

[in] Process

Pointeur vers un processus (PEPROCESS).

[in] Callback

Fonction de rappel à appeler. Ce paramètre est de type PS_AVAILABLE_CPUS_CHANGE_CALLBACK.

[in, optional] Context

Pointeur vers un paramètre de contexte qui sera passé à la fonction de rappel.

[in, optional] ObservedSequenceNumber

Fournissez éventuellement un pointeur vers le numéro de séquence de processeurs disponible le plus récent observé par l’appelant. Si le numéro de séquence a avancé depuis cette observation, un rappel est effectué immédiatement.

[out] RegistrationHandle

Fournit un pointeur vers une mémoire tampon qui, en cas de réussite, reçoit un handle à l’inscription de rappel (PS_AVAILABLE_CPUS_CHANGE_REGISTRATION).

Valeur retournée

PsRegisterProcessAvailableCpusChangeNotification retourne l’une des valeurs NTSTATUS suivantes :

Remarques

Cette routine doit être appelée à PASSIVE_LEVEL.

Le rappel est appelé chaque fois que l’ensemble de processeurs disponibles pour le processus spécifié change. Cela peut se produire en raison d’opérations de plug-in de l’UC, de modifications d’affinité de processus ou d’autres événements système.

Pour annuler l’inscription du rappel, appelez PsUnregisterAvailableCpusChangeNotification avec le handle d’inscription retourné par cette fonction.

Si un Objet ObservedSequenceNumber est fourni et que le numéro de séquence actuel est avancé au-delà de celui-ci, le rappel est appelé immédiatement lors de l’inscription.

Spécifications

Voir aussi

PsUnregisterAvailableCpusChangeNotification

PsRegisterSystemAvailableCpusChangeNotification

PS_AVAILABLE_CPUS_CHANGE_CALLBACK