Fonction PowerSettingRegisterNotification (powersetting.h)

  • Article

S’inscrit pour recevoir une notification lorsqu’un paramètre d’alimentation change.

Syntaxe

DWORD PowerSettingRegisterNotification(
  [in]  LPCGUID       SettingGuid,
  [in]  DWORD         Flags,
  [in]  HANDLE        Recipient,
  [out] PHPOWERNOTIFY RegistrationHandle
);

Paramètres

[in] SettingGuid

GUID qui représente le paramètre d’alimentation.

[in] Flags

Informations sur le destinataire de la notification. Ce paramètre peut être l’une des valeurs suivantes :

Valeur Signification
DEVICE_NOTIFY_SERVICE_HANDLE
 Le paramètre Recipient est un handle pour un service. Utilisez la fonction CreateService ou OpenService pour obtenir ce handle.
DEVICE_NOTIFY_CALLBACK
 Le paramètre Recipient est un pointeur vers une fonction de rappel à appeler lorsque le paramètre d’alimentation change. Dans ce cas, le destinataire est censé être de type PDEVICE_NOTIFY_SUBSCRIBE_PARAMETERS.

[in] Recipient

Handle pour le destinataire des notifications.

[out] RegistrationHandle

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

Valeur retournée

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

Remarques

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 paramètre d’alimentation change, vous pouvez recevoir plusieurs rappels ; le dernier rappel est la mise à jour la plus récente.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête powersetting.h
Bibliothèque Powrprof.lib
DLL Powrprof.dll

Voir aussi

GUID de paramètre d’alimentation

PowerSettingUnregisterNotification