SYSTEM_POWER_STATUS_EX2 (Compact 2013)

  • Article

3/28/2014

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

Syntax

typedef struct _SYSTEM_POWER_STATUS_EX2 {
  BYTE ACLineStatus;
  BYTE BatteryFlag;
  BYTE BatteryLifePercent;
  BYTE Reserved1;
  DWORD BatteryLifeTime;
  DWORD BatteryFullLifeTime;
  BYTE Reserved2;
  BYTE BackupBatteryFlag;
  BYTE BackupBatteryLifePercent;
  BYTE Reserved3;
  DWORD BackupBatteryLifeTime;
  DWORD BackupBatteryFullLifeTime;
  DWORD BatteryVoltage;
  DWORD BatteryCurrent;
  DWORD BatteryAverageCurrent;
  DWORD BatteryAverageInterval;
  DWORD BatterymAHourConsumed;
  DWORD BatteryTemperature;
  DWORD BackupBatteryVoltage;
  BYTE BatteryChemistry;
  //  Add any extra information after the BatteryChemistry member.
} SYSTEM_POWER_STATUS_EX2, *PSYSTEM_POWER_STATUS_EX2, *LPSYSTEM_POWER_STATUS_EX2;

Members

  • ACLineStatus
    AC power status. This member can be one of the values in the following table.

    Value

    Description

    AC_LINE_OFFLINE

    Offline

    AC_LINE_ONLINE

    Online

    AC_LINE_BACKUP_POWER

    Backup Power

    AC_LINE_UNKNOWN

    Unknown status

    All other values are reserved.

  • BatteryFlag
    Battery charge status. This member can be a combination of the values in the following table. All other values are reserved.

    Value

    Description

    BATTERY_FLAG_HIGH

    High

    BATTERY_FLAG_LOW

    Low

    BATTERY_FLAG_CRITICAL

    Critical

    BATTERY_FLAG_CHARGING

    Charging

    BATTERY_FLAG_NO_BATTERY

    No system battery

    BATTERY_FLAG_UNKNOWN

    Unknown status
  • BatteryLifePercent
    Percentage of full battery charge remaining. This member can be a value in the range 0 to 100, or BATTERY_PERCENTAGE_UNKNOWN if the status is unknown. All other values are reserved.
  • Reserved1
    Reserved; set to 0 (zero).
  • BatteryLifeTime
    Number of seconds of battery life remaining, or BATTERY_LIFE_UNKNOWN if remaining seconds are unknown.
  • BatteryFullLifeTime
    Number of seconds of battery life when at full charge, or BATTERY_LIFE_UNKNOWN if full battery lifetime is unknown.
  • Reserved2
    Reserved; set to 0 (zero).

  • BackupBatteryFlag
    Backup battery charge status. This member can be a combination 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. This value must be in the range 0 to 100, or BATTERY_PERCENTAGE_UNKNOWN.
  • Reserved3
    Reserved; set to 0 (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 battery lifetime is unknown.
  • BatteryVoltage
    Amount of battery voltage in millivolts (mV). This member can have a value in the range of 0 to 65,535.
  • BatteryCurrent
    Amount of instantaneous current drain in milliamperes (mA). This member can have a value in the range of 0 to 32,767 for charge, or 0 to -32,768 for discharge.
  • BatteryAverageCurrent
    Short-term average of device current drain (mA). This member can have a value in the range of 0 to 32,767 for charge, or 0 to -32,768 for discharge.
  • BatteryAverageInterval
    Time constant in milliseconds (ms) of integration used in reporting BatteryAverageCurrent.
  • BatterymAHourConsumed
    Long-term cumulative average discharge in milliamperes per hour (mAH). This member can have a value in the range of 0 to -32,768. This value can be reset by charging or changing the batteries.
  • BatteryTemperature
    Battery temperature in degrees Celsius. This member can have a value in the range of -3,276.8 to 3,276.7; the increments are 0.1 degrees Celsius.
  • BackupBatteryVoltage
    Backup battery voltage in mV.

  • BatteryChemistry
    This can be one of the values in the following table.

    Value

    Description

    BATTERY_CHEMISTRY_ALKALINE

    Alkaline battery.

    BATTERY_CHEMISTRY_NICD

    Nickel Cadmium battery.

    BATTERY_CHEMISTRY_NIMH

    Nickel Metal Hydride battery.

    BATTERY_CHEMISTRY_LION

    Lithium Ion battery.

    BATTERY_CHEMISTRY_LIPOLY

    Lithium Polymer battery.

    BATTERY_CHEMISTRY_ZINCAIR

    Zinc Air battery.

    BATTERY_CHEMISTRY_UNKNOWN

    Battery chemistry is unknown.

Remarks

To return additional battery information, such as information about an extra battery, provide a data buffer larger than SYSTEM_POWER_STATUS_EX2 in the GetSystemPowerStatusEx2 function. Any extra information must be added after the BatteryChemistry member of the SYSTEM_POWER_STATUS_EX2 structure. There must be support for this implemented in the battery driver, and the implementation of this support varies depending on the hardware platform.

There is a clear distinction between ACLineStatus and BATTERY_FLAG_CHARGING, where the former indicates whether the device is plugged in to a power source, and the latter indicates that the device is plugged in and the battery is charging.

Requirements

Header

winbase.h

See Also

Reference

System Information Structures
GetSystemPowerStatusEx2