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) |