BATTERY_STATUS structure
Contient l’état actuel de la batterie. Cette structure est utilisée par le code de contrôle IOCTL_BATTERY_QUERY_STATUS .
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 - BATTERY_CHARGING
- 0x00000004
Indique que la batterie est en cours de chargement. - BATTERY_CRITICAL
- 0x00000008
Indique que la défaillance de la batterie est imminente. Pour plus d'informations, consultez la section Notes. - BATTERY_DISCHARGING
- 0x00000002
Indique que la batterie est en cours de décharge. - BATTERY_POWER_ON_LINE
- 0x00000001
Indique que le système a accès à l’alimentation secteur, de sorte qu’aucune batterie n’est déchargée. -
Capacité
-
Capacité actuelle de la batterie, en mWh (ou relative). Cette valeur peut être utilisée pour générer un affichage « jauge de gaz » en le divisant par le membre FullChargedCapacity de la structure BATTERY_INFORMATION . Si la capacité n’est pas disponible, ce membre est BATTERY_UNKNOWN_CAPACITY.
-
Voltage
-
Tension actuelle de la batterie sur les bornes de batterie, en millivolts (mv). Si la tension n’est pas disponible, ce membre est BATTERY_UNKNOWN_VOLTAGE.
-
Tarif
-
Taux actuel de charge ou de décharge de la batterie. Cette valeur sera exprimée en milliwatts, sauf si les informations sur le débit de la batterie sont relatives, auquel cas elles seront exprimées en unités arbitraires par heure. Pour déterminer si les informations sur la batterie sont relatives, examinez l’indicateur BATTERY_CAPACITY_RELATIVE dans le membre Capabilities de la structure BATTERY_INFORMATION . Un taux positif différent de zéro indique la facturation; un taux négatif indique une décharge. Certaines batteries ne signalent que des taux de décharge. Si le taux n’est pas disponible, ce membre est BATTERY_UNKNOWN_RATE. Si l’état de la batterie ou de la source d’alimentation change, le débit peut devenir disponible.
Notes
L’indicateur BATTERY_CRITICAL 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 l'« alarme de batterie critique ». Cela signifie généralement que le système de batterie a calculé que la batterie est totalement vidée, et toute puissance tirée est au-delà de ce qui est attendu.
Spécifications
Condition requise | Valeur |
---|---|
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 |
|