Structure d’état de la batterie _

Contient l’état actuel de la batterie. Cette structure est utilisée par le code de contrôle de l’état de la _ requête de batterie _ _ IOCTL .

Syntaxe

typedef struct _BATTERY_STATUS {
  ULONG PowerState;
  ULONG Capacity;
  ULONG Voltage;
  LONG  Rate;
} BATTERY_STATUS, *PBATTERY_STATUS;

Membres

PowerState

État de la batterie. Ce membre peut être égal à zéro, une ou plusieurs des valeurs suivantes.

Valeur Signification
Batterie _ CHARGEMENT
de
0x00000004
Indique que la batterie est en cours de chargement.
Batterie _
0x00000008
critique
Indique que la défaillance de la batterie est imminente. Pour plus d'informations, consultez la section Notes.
Batterie _ Déchargement
de
0x00000002
Indique que la batterie est en cours de déchargement.
Batterie _ METTRE _ sous _ tension
0x00000001
Indique que le système a accès à l’alimentation secteur, donc aucune batterie n’est en cours de défacturation.

Capacité

Capacité actuelle de la batterie, en mWh (ou relatif). Cette valeur peut être utilisée pour générer un affichage de « jauge de gaz » en le divisant par le membre FullChargedCapacity de la structure d' _ informations sur la batterie . Si la capacité n’est pas disponible, il s’agit de la capacité inconnue de la batterie _ _ .

Voltage

Tension actuelle de la batterie sur les bornes de la batterie, en millivolts (MV). Si la tension n’est pas disponible, il s’agit d’une tension de batterie _ inconnue _ .

Tarif

Taux actuel de charge ou de décharge de la batterie. Cette valeur sera en milliwatts, sauf si les informations relatives au taux de batterie sont relatives, auquel cas elle sera en unités arbitraires par heure. Pour déterminer si les informations sur la batterie sont relatives, examinez l' _ indicateur relatif à la capacité de la batterie _ dans le membre capacités de la structure d' _ informations sur la batterie . Un taux positif différent de zéro indique une charge ; un taux négatif indique un déchargement. Certaines batteries signalent uniquement des taux de rejet. Si le taux n’est pas disponible, la fréquence de la batterie est inconnue pour ce membre _ _ . Si l’état de la batterie ou de la source d’alimentation change, le taux peut devenir disponible.

Remarques

L' _ indicateur critique de la batterie dans le membre PowerState de cette structure indique une condition matérielle « critique pour la batterie ». Ce niveau critique est défini par le fabricant de la batterie, et non par l’utilisateur dans la « alarme de batterie critique ». Cela signifie généralement que le système de batterie a calculé que la batterie est entièrement drainée et que toute puissance dessinée dépasse ce qui est attendu.

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 la batterie

État de la _ requête de batterie IOCTL _ _