Partager via


Méthode ISensOnNow ::BatteryLow (sensevts.h)

La méthode BatteryLow avertit une application que la puissance de la batterie est faible. SENS appelle la méthode BatteryLow pour informer une application qu’un ordinateur utilise l’alimentation de la batterie.

Une faible alimentation de la batterie est signalée lorsqu’un système est alimenté par la batterie et que la batterie est faible selon la même logique utilisée par l’événement APM (Advanced Power Management) PBT_APMBATTERYLOW. Cet événement est diffusé lorsqu’un BIOS APM système envoie une notification de batterie APM faible.

Certaines implémentations du BIOS APM ne fournissent pas de notifications lorsque les batteries sont faibles, ce qui signifie que cet événement peut ne jamais être diffusé sur certains ordinateurs.

Syntaxe

HRESULT BatteryLow(
  [in] DWORD dwBatteryLifePercent
);

Paramètres

[in] dwBatteryLifePercent

Pourcentage d’alimentation de la batterie restante.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
La méthode retourne correctement.

Remarques

SENS appelle cette méthode pour informer une application qu’un ordinateur utilise l’alimentation de la batterie. Le pourcentage restant d’alimentation de la batterie est spécifié.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête sensevts.h
DLL Sens.dll

Voir aussi

À propos du service de notification d’événements système

IEventSubscription

IEventSubscription ::P utPublisherProperty

ISensOnNow

ISensOnNow ::OnBatteryPower