This structure contains information about the power status of the system.
At a Glance
Header file: | Winbase.h |
Windows CE versions: | 1.0 and later |
Syntax
typedef struct _SYSTEM_POWER_STATUS_EX {
BYTE ACLineStatus;
BYTE BatteryFlag;
BYTE BatteryLifePercent;
BYTE Reserved1;
DWORD BatteryLifeTime;
DWORD BatteryFullLifeTime;
BYTE Reserved2;
BYTE BackupBatteryFlag;
BYTE BackupBatteryLifePercent;
BYTE Reserved3;
DWORD BackupBatteryLifeTime;
DWORD BackupBatteryFullLifeTime;
} SYSTEM_POWER_STATUS_EX, *PSYSTEM_POWER_STATUS_EX, *LPSYSTEM_POWER_STATUS_EX;
Members
ACLineStatus
AC power status. It is one of the following values:
Value | Description |
0 | Offline |
1 | Online |
255 | Unknown status |
All other values are reserved.
BatteryFlag
Battery charge status. It can be a combination of the following values:
Value | Description |
1 | High |
2 | Low |
4 | Critical |
8 | Charging |
128 | No system battery |
255 | Unknown status |
All other values are reserved.
BatteryLifePercent
Percentage of full battery charge remaining. This member can be a value in the range 0 to 100, or 255 if status is unknown. All other values are reserved.
Reserved1
Reserved; set to zero.
BatteryLifeTime
Number of seconds of battery life remaining, or 0xFFFFFFFF if remaining seconds are unknown.
BatteryFullLifeTime
Number of seconds of battery life when at full charge, or 0xFFFFFFFF if full lifetime is unknown.
Reserved2
Reserved; set to zero.
BackupBatteryFlag
Backup battery charge status. It is one of the following values:
BATTERY_FLAG_HIGH |
BATTERY_FLAG_CRITICAL |
BATTERY_FLAG_CHARGING |
BATTERY_FLAG_NO_BATTERY |
BATTERY_FLAG_UNKNOWN |
BATTERY_FLAG_LOW |
BackupBatteryLifePercent
Percentage of full backup battery charge remaining. Must be in the range 0 to 100, or BATTERY_PERCENTAGE_UNKNOWN.
Reserved3
Reserved; set to zero
BackupBatteryLifeTime
Number of seconds of backup battery life remaining, or BATTERY_LIFE_UNKNOWN if remaining seconds are unknown.
BackupBatteryFullLifeTime
Number of seconds of backup battery life when at full charge, or BATTERY_LIFE_UNKNOWN if full lifetime is unknown.