POWER_BROADCAST_POWER_INFO (Compact 2013)

3/26/2014

This structure is used instead of a string name in the POWER_BROADCAST structure if the broadcast is of type PBT_POWERINFOCHANGE.

Syntax

typedef struct _POWER_BROADCAST_POWER_INFO {
  DWORD dwBatteryLifeTime;
  DWORD dwBatteryFullLifeTime;
  DWORD dwBackupBatteryLifeTime;
  DWORD dwBackupBatteryFullLifeTime;
  BYTE bACLineStatus;
  BYTE bBatteryFlag;
  BYTE bBatteryLifePercent;
  BYTE bBackupBatteryFlag;
  BYTE bBackupBatteryLifePercent;
} POWER_BROADCAST_POWER_INFO, *PPOWER_BROADCAST_POWER_INFO;

Members

• dwBatteryLifeTime
  Number of seconds of battery life remaining, or 0xFFFFFFFF if remaining seconds are unknown.

• dwBatteryFullLifeTime
  Number of seconds of battery life when at full charge, or 0xFFFFFFFF if full battery lifetime is unknown.

• dwBackupBatteryLifeTime
  Number of seconds of backup battery life remaining, or BATTERY_LIFE_UNKNOWN if remaining seconds are unknown.

• dwBackupBatteryFullLifeTime
  Number of seconds of backup battery life when at full charge, or BATTERY_LIFE_UNKNOWN if full battery lifetime is unknown.

• bACLineStatus
  AC power status. This member can be one of the values in the following table. Values not in the table are reserved.

  Value	Description
  0	Offline
  1	Online
  255	Unknown status

• bBatteryFlag
  Battery charge status. This member can be a combination of the values in the following table. Values not in the table are reserved.

  Value	Description
  1	High
  2	Low
  4	Critical
  8	Charging
  128	No system battery
  255	Unknown status

• bBatteryLifePercent
  Percentage of full battery charge remaining. This member can be a value in the range zero to 100, or 255 if the status is unknown. All other values are reserved.

• bBackupBatteryFlag
  Backup battery charge status. This member can be one of the following values:

  • BATTERY_FLAG_HIGH
  • BATTERY_FLAG_CRITICAL
  • BATTERY_FLAG_CHARGING
  • BATTERY_FLAG_NO_BATTERY
  • BATTERY_FLAG_UNKNOWN
  • BATTERY_FLAG_LOW

• bBackupBatteryLifePercent
  Percentage of full backup battery charge remaining. This value must be in the range of zero to 100, or BATTERY_PERCENTAGE_UNKNOWN.

Requirements

See Also

Reference

Power Management Structures
POWER_BROADCAST