structure SYSTEM_BATTERY_STATE (winnt.h)
Contient des informations sur l’état actuel de la batterie système.
Syntaxe
typedef struct {
BOOLEAN AcOnLine;
BOOLEAN BatteryPresent;
BOOLEAN Charging;
BOOLEAN Discharging;
BOOLEAN Spare1[3];
BYTE Tag;
DWORD MaxCapacity;
DWORD RemainingCapacity;
DWORD Rate;
DWORD EstimatedTime;
DWORD DefaultAlert1;
DWORD DefaultAlert2;
} SYSTEM_BATTERY_STATE, *PSYSTEM_BATTERY_STATE;
Membres
AcOnLine
Si ce membre a la valeur TRUE, le chargeur de batterie système fonctionne actuellement sur l’alimentation externe.
BatteryPresent
Si ce membre a la valeur TRUE, au moins une batterie est présente dans le système.
Charging
Si ce membre a la valeur TRUE, une batterie est en cours de chargement.
Discharging
Si ce membre a la valeur TRUE, une batterie est en cours de décharge.
Spare1[3]
Réservé.
Tag
MaxCapacity
Capacité théorique de la batterie lorsqu’elle est neuve.
RemainingCapacity
Capacité restante estimée de la batterie.
Rate
Taux actuel de décharge de la batterie, en mW. Un taux positif différent de zéro indique la charge; un taux négatif indique une décharge. Certaines batteries signalent uniquement des taux de décharge. Cette valeur doit être traitée comme une valeur LONG , car elle peut contenir des valeurs négatives (avec le bit élevé défini).
EstimatedTime
Temps restant estimé sur la batterie, en secondes.
DefaultAlert1
La suggestion du fabricant d’une capacité, en mWh, à laquelle une alerte de batterie faible devrait se produire. Les définitions de faible varient d’un fabricant à l’autre. En général, un état d’avertissement se produit avant un état faible, mais vous ne devez pas supposer qu’il le fera toujours. Pour réduire le risque de perte de données, cette valeur est généralement utilisée comme paramètre par défaut pour l’alarme de batterie critique.
DefaultAlert2
La suggestion du fabricant d’une capacité, en mWh, à laquelle une alerte de batterie d’avertissement devrait se produire. Les définitions de l’avertissement varient d’un fabricant à l’autre. En général, un état d’avertissement se produit avant un état faible, mais vous ne devez pas supposer qu’il le fera toujours. Pour réduire le risque de perte de données, cette valeur est généralement utilisée comme paramètre par défaut pour l’alarme de batterie faible.
Configuration requise
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| En-tête | winnt.h (inclure Windows.h) |