structure SYSTEM_POWER_STATUS (winbase.h)

Article
08/27/2023

Contient des informations sur la status d’alimentation du système.

Syntaxe

typedef struct _SYSTEM_POWER_STATUS {
  BYTE  ACLineStatus;
  BYTE  BatteryFlag;
  BYTE  BatteryLifePercent;
  BYTE  SystemStatusFlag;
  DWORD BatteryLifeTime;
  DWORD BatteryFullLifeTime;
} SYSTEM_POWER_STATUS, *LPSYSTEM_POWER_STATUS;

Membres

ACLineStatus

Status d’alimentation secteur. Ce membre peut être l’une des valeurs suivantes.

Valeur	Signification
0	Hors connexion
1	En ligne
255	État Inconnu

BatteryFlag

La charge de la batterie status. Ce membre peut contenir un ou plusieurs des indicateurs suivants.

Valeur	Signification
1	Élevé : la capacité de la batterie est supérieure à 66 %
2	Faible : la capacité de la batterie est inférieure à 33 %
4	Critique : la capacité de la batterie est inférieure à cinq pour cent
8	Charge
128	Aucune batterie système
255	Status inconnu : impossible de lire les informations d’indicateur de batterie

La valeur est égale à zéro si la batterie n’est pas chargée et si la capacité de la batterie est comprise entre faible et élevée.

BatteryLifePercent

Pourcentage de charge totale de la batterie restante. Ce membre peut être une valeur comprise entre 0 et 100, ou 255 si status est inconnu.

SystemStatusFlag

Status de l’économiseur de batterie. Pour participer à l’économie d’énergie, évitez les tâches nécessitant beaucoup de ressources lorsque l’économiseur de batterie est activé. Pour être averti lorsque cette valeur change, appelez la fonction RegisterPowerSettingNotification avec le GUID du paramètre d’alimentation, GUID_POWER_SAVING_STATUS.

Valeur	Signification
0	L’économiseur de batterie est désactivé.
1	Économiseur de batterie activé. Économisez de l’énergie lorsque cela est possible.

Note Cet indicateur et le GUID de GUID_POWER_SAVING_STATUS ont été introduits dans Windows 10. Cet indicateur était précédemment réservé, nommé Reserved1, et avait la valeur 0.

Pour obtenir des informations générales sur l’économiseur de batterie, consultez Économiseur de batterie (dans les instructions relatives aux composants matériels).

BatteryLifeTime

Nombre de secondes restantes d’autonomie de la batterie, ou –1 si les secondes restantes sont inconnues ou si l’appareil est connecté à l’alimentation secteur.

BatteryFullLifeTime

Nombre de secondes d’autonomie de la batterie en cas de charge complète, ou –1 si la durée de vie de la batterie est inconnue ou si l’appareil est connecté à l’alimentation secteur.

Remarques

Le système est uniquement capable d’estimer BatteryFullLifeTime en fonction des calculs sur BatteryLifeTime et BatteryLifePercent. Sans sous-systèmes de batterie intelligents, cette valeur peut ne pas être suffisamment précise pour être utile.

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	winbase.h (inclure Windows.h)

Voir aussi

GetSystemPowerStatus

PBT_APMPOWERSTATUSCHANGE

économiseur de batterie (dans les instructions relatives aux composants matériels)

Partager via