SYSTEM_POWER_STATUS_EX (RAPI)

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure contains information about the power status of the system.

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
  2	Backup power
  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.

  Flag
  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.

Requirements

See Also

Concepts

RAPI Structures