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)

Voir aussi

CallNtPowerInformation