winnt.h) (SYSTEM_BATTERY_STATE 结构
包含有关系统电池当前状态的信息。
语法
typedef struct {
BOOLEAN AcOnLine;
BOOLEAN BatteryPresent;
BOOLEAN Charging;
BOOLEAN Discharging;
BOOLEAN Spare1[3];
BYTE Tag;
DWORD MaxCapacity;
DWORD RemainingCapacity;
DWORD Rate;
DWORD EstimatedTime;
DWORD DefaultAlert1;
DWORD DefaultAlert2;
} SYSTEM_BATTERY_STATE, *PSYSTEM_BATTERY_STATE;
成员
AcOnLine
如果此成员为 TRUE,则表示系统电池充电器当前使用外部电源工作。
BatteryPresent
如果此成员为 TRUE,则系统中至少有一个电池。
Charging
如果此成员为 TRUE,则表示电池当前正在充电。
Discharging
如果此成员为 TRUE,则表示电池当前正在放电。
Spare1[3]
保留。
Tag
MaxCapacity
新电池的理论容量。
RemainingCapacity
电池的估计剩余容量。
Rate
电池的当前放电率(以 mW 为单位)。 非零正率表示正在充电;负速率表示正在释放。 某些电池仅报告放电率。 此值应被视为 LONG ,因为它可以包含 (高位设置) 的负值。
EstimatedTime
电池剩余的估计时间(以秒为单位)。
DefaultAlert1
制造商建议的容量(以 mWh 为单位),此时会出现电池电量不足警报。 低的定义因制造商而异。 一般情况下,警告状态将出现在低状态之前,但不应假定它始终会出现。 为了降低数据丢失的风险,此值通常用作严重电池警报的默认设置。
DefaultAlert2
制造商建议的容量(以 mWh 为单位),此时应发生电池警告警报。 警告的定义因制造商而异。 一般情况下,警告状态将出现在低状态之前,但不应假定它始终会出现。 为了降低数据丢失的风险,此值通常用作电池电量不足警报的默认设置。
要求
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
标头 | winnt.h (包括 Windows.h) |