_Structure d’informations sur la batterie

Contient des informations sur la batterie. Cette structure est retournée par le code de contrôle des informations de requête de la _ batterie _ _ IOCTL lorsque le niveau d’information 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

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

Valeur Signification
Batterie _ 0x40000000 _ relative
à la capacité
Indique que les informations relatives à la capacité et au taux de la batterie sont relatives, et non dans des unités spécifiques. Si ce bit n’est pas défini, les unités de rapport sont milliwatts heure-Hours (mWh) pour Capacity et milliwatts (mW) pour rate. Si ce bit est défini, toutes les références aux unités dans la documentation de l’autre batterie peuvent être ignorées. Toutes les informations sur les taux sont signalées en unités par heure. Par exemple, si la capacité entièrement facturée est signalée comme 100, un taux de 200 indique que la batterie utilise toute sa capacité en une demi-heure.
Batterie _ EST 0x20000000 à _ bref _ terme
Indique que l’opération normale est destinée à une fonction de prévention de défaillance. Si ce bit n’est pas défini, la batterie est censée être utilisée lors de l’utilisation normale du système.
Batterie _ DÉFINIR les _ frais _ pris en charge
0x00000001
Indique que les demandes d’informations set du type BatteryCharge sont prises en charge par ce périphérique de batterie.
Batterie _ DÉFINIR un _ rejet _ pris en charge
0x00000002
Indique que les demandes d’informations set du type BatteryDischarge sont prises en charge par ce périphérique de batterie.
Batterie _ _Batterie système
0x80000000
Indique que la batterie peut fournir une alimentation générale pour l’exécution du système.

Technology

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

Valeur Signification
0
Batterie Nonrechargeable, par exemple, alcaline.
1
Batterie refacturable, par exemple, l’acide de leads.

Reserved

Réservé.

Chimique

Chaîne de caractères abrégée qui indique la chimie de la batterie. Cette chaîne ne se termine pas nécessairement par zéro. Voici une liste partielle des abréviations qui peuvent être retournées et des Chemistries associés.

chaîne Unicode Signification
PbAc
Acidité
LION
Lithium-ion
Li-I
Lithium-ion
NiCd
Nickel cadmium
NiMH
Nickel metal-hydrure
NiZn
Nickel-zinc
RAM
Alkaline-Manganese refacturable

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

DesignedCapacity

Capacité théorique de la batterie lorsqu’elle est nouvelle, dans mWh, sauf si la capacité de la batterie _ _ est définie. Dans ce cas, les unités ne sont pas définies.

FullChargedCapacity

Capacité totale actuelle de la batterie dans mWh (ou relative). Comparez cette valeur à DesignedCapacity pour estimer l’usure de la batterie.

DefaultAlert1

Capacité suggérée par le fabricant, en mWh, à laquelle une alerte de batterie faible doit se produire. Les définitions de faible varient d’un fabricant au fabricant. En général, un état d’avertissement se produit avant un État faible, mais vous ne devez pas supposer qu’il le sera toujours. Pour réduire les risques 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 doit se produire. Les définitions d’avertissement varient d’un fabricant à l’autres. En général, un état d’avertissement se produit avant un État faible, mais vous ne devez pas supposer qu’il le sera toujours. Pour réduire les risques de perte de données, cette valeur est généralement utilisée comme paramètre par défaut pour l’alerte de batterie faible.

CriticalBias

Biais de zéro, dans mWh, qui est appliqué à la création de rapports de batterie. Certaines batteries réservent une petite charge qui est écartée des valeurs de capacité de la batterie pour afficher « 0 » comme niveau de batterie critique. Le décalage critique est similaire à la définition d’une jauge de carburant pour afficher « vide » lorsqu’il existe plusieurs litres de carburant.

CycleCount

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

Remarques

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows [Applications de bureau XP uniquement]
Serveur minimal pris en charge
Windows Serveur 2003 [ applications de bureau uniquement]
En-tête
Poclass. h ;
Batclass. h sur Windows server 2008 R2, Windows 7, Windows server 2008, Windows Vista, Windows server 2003 et Windows XP

Voir aussi

_ _ informations sur les requêtes de batterie IOCTL _