Compartilhar via


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

Header

pm.h

See Also

Reference

Power Management Structures
POWER_BROADCAST