structure BATTERY_INFORMATION

Contient des informations sur la batterie. Cette structure est retournée par le code de contrôle IOCTL_BATTERY_QUERY_INFORMATION lorsque le niveau d’informations BatteryInformation est demandé.

Syntaxe

typedef struct _BATTERY_INFORMATION {
  ULONG Capabilities;
  UCHAR Technology;
  UCHAR Reserved[3];
  UCHAR Chemistry[4];
  ULONG DesignedCapacity;
  ULONG FullChargedCapacity;
  ULONG DefaultAlert1;
  ULONG DefaultAlert2;
  ULONG CriticalBias;
  ULONG CycleCount;
} BATTERY_INFORMATION, *PBATTERY_INFORMATION;

Membres

Capabilities

Fonctionnalités de la batterie. Ce membre peut être une ou plusieurs des valeurs suivantes.

Valeur	Signification
BATTERY_CAPACITY_RELATIVE 0x40000000	Indique que la capacité de la batterie et les informations de débit sont relatives, et pas dans des unités spécifiques. Si ce bit n’est pas défini, les unités de rapport sont des milliwatt-heures (mWh) pour la capacité et des milliwatts (mW) pour le débit. Si ce bit est défini, toutes les références à des unités dans l’autre documentation sur la batterie peuvent être ignorées. Toutes les informations de débit sont signalées en unités par heure. Par exemple, si la capacité entièrement chargée est signalée comme 100, un taux de 200 indique que la batterie utilisera toute sa capacité en une demi-heure.
BATTERY_IS_SHORT_TERM 0x20000000	Indique que l’opération normale est pour une fonction de sécurité automatique. Si ce bit n’est pas défini, la batterie est censée être utilisée pendant l’utilisation normale du système.
BATTERY_SET_CHARGE_SUPPORTED 0x00000001	Indique que les demandes d’informations de type BatteryCharge sont prises en charge par ce périphérique de batterie.
BATTERY_SET_DISCHARGE_SUPPORTED 0x00000002	Indique que les demandes d’informations de type BatteryDischarge sont prises en charge par ce périphérique de batterie.
BATTERY_SYSTEM_BATTERY 0x80000000	Indique que la batterie peut fournir une alimentation générale pour exécuter le système.

Technology

La technologie de la batterie. Ce membre peut être l’une des valeurs suivantes.

Valeur	Signification
0	Batterie non rechargeable, par exemple, alcaline.
1	Batterie rechargeable, par exemple, acide de plomb.

Reserved

Réservé.

Chimie

Chaîne de caractères abrégée qui indique la chimie de la batterie. Cette chaîne n’est pas nécessairement terminée à zéro. Voici une liste partielle des abréviations qui peuvent être retournées et les chimies associées.

chaîne Unicode	Signification
PbAc	Acide de plomb
LION	Lithium Ion
Li-I	Lithium Ion
Nicd	Nickel Cadmium
Nimh	Hydrure nickel métal
Nizn	Nickel Zinc
RAM	Alkaline-Manganese rechargeable

D’autres chimies peuvent apparaître à l’avenir et votre code doit être en mesure de les gérer.

ConçuCapacité

Capacité théorique de la batterie lorsqu’elle est neuve, en mWh, sauf si BATTERY_CAPACITY_RELATIVE est défini. Dans ce cas, les unités ne sont pas définies.

FullChargedCapacity

Capacité actuelle entièrement chargée de la batterie en mWh (ou relative). Comparez cette valeur à DesignedCapacity pour estimer l’usure de la batterie.

DefaultAlert1

La capacité suggérée par le fabricant, 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

Capacité suggérée par le fabricant, 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.

CriticalBias

Un biais de zéro, en mWh, qui est appliqué aux rapports de batterie. Certaines batteries réservent une petite charge qui est biaisée des valeurs de capacité de la batterie pour afficher « 0 » comme niveau de batterie critique. La partialité critique est analogue à la définition d’une jauge de carburant pour afficher « vide » lorsqu’il reste plusieurs litres de carburant.

CycleCount

Nombre de cycles de charge/décharge que la batterie a subis. Cela permet de déterminer l’usure de la batterie. Si la batterie ne prend pas en charge un compteur de cycle, ce membre est égal à zéro.

Notes

En règle générale, un état d’avertissement se produit avant un état faible, mais vous ne devez pas supposer qu’il le fera. Il est possible d’interroger une batterie et de constater qu’aucun niveau d’alerte ne s’est produit, et interroger à nouveau la batterie et de la constater déchargée dans la mesure où les deux niveaux ont été atteints. Cela peut indiquer que vous n’interrogez pas assez souvent. Cela peut également indiquer que la batterie ne peut pas tenir une charge pendant très longtemps et se décharge plus rapidement que prévu. Une telle batterie peut être proche de la fin de sa durée de vie utile, ou elle peut être endommagée.

Spécifications

Voir aussi

IOCTL_BATTERY_QUERY_INFORMATION