SYSTEM_BATTERY_STATE結構 (winnt.h)

包含系統電池目前狀態的相關資訊。

語法

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