Fonction PowerRegisterForEffectivePowerModeNotifications (powersetting.h)

Article
08/25/2023

Inscrit un rappel pour recevoir des notifications de changement de mode d’alimentation effectives.

Syntaxe

HRESULT PowerRegisterForEffectivePowerModeNotifications(
  ULONG                         Version,
  EFFECTIVE_POWER_MODE_CALLBACK *Callback,
  PVOID                         Context,
  PVOID                         *RegistrationHandle
);

Paramètres

Version

Fournit la version maximale du mode d’alimentation effective que l’appelant comprend. Si le mode d’alimentation effectif provient d’une version ultérieure, il est réduit à une version compatible qui est ensuite passée au rappel.

Les valeurs suivantes peuvent être transmises :

EFFECTIVE_POWER_MODE_V1 est disponible à partir de Windows 10, version 1809 et suit les états du curseur d’alimentation et de l’économiseur de batterie.
EFFECTIVE_POWER_MODE_V2 est disponible à partir de Windows 10 version 1903 et suit les états d’alimentation du curseur d’alimentation, de l’économiseur de batterie, du mode de jeu et de la réalité mixte windows.

Callback

Pointeur vers le rappel à appeler lorsque le mode d’alimentation effectif change. Cela sera également appelé une fois lors de l’inscription pour fournir le mode actuel. Si plusieurs rappels sont inscrits à l’aide de cette API, ces rappels peuvent être appelés simultanément.

Context

Contexte opaque spécifié par l’appelant.

RegistrationHandle

Handle de l’inscription. Utilisez ce handle pour annuler l’inscription aux notifications.

Valeur retournée

Retourne S_OK (zéro) si l’appel a réussi et une valeur différente de zéro si l’appel a échoué.

Notes

Immédiatement après l’inscription, le rappel est appelé avec la valeur actuelle du paramètre d’alimentation. Si l’inscription se produit alors que le mode d’alimentation change, vous pouvez recevoir plusieurs rappels ; le dernier rappel est la mise à jour la plus récente.

Spécifications


Client minimal pris en charge	Windows 10, version 1809 [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	powersetting.h
Bibliothèque	Powrprof.lib
DLL	Powrprof.dll

Partager via