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)

另请参阅

CallNtPowerInformation