BATTERY_STATUS 結構
包含電池的目前狀態。 IOCTL_BATTERY_QUERY_STATUS 控制項程式 代碼會使用此結構。
語法
typedef struct _BATTERY_STATUS {
ULONG PowerState;
ULONG Capacity;
ULONG Voltage;
LONG Rate;
} BATTERY_STATUS, *PBATTERY_STATUS;
成員
-
PowerState
-
電池狀態。 這個成員可以是零、一或多個下列值。
值 意義 - BATTERY_CHARGING
- 0x00000004
表示電池目前正在充電。 - BATTERY_CRITICAL
- 0x00000008
表示電池故障即將發生。 如需詳細資訊，請參閱＜備註＞一節。 - BATTERY_DISCHARGING
- 0x00000002
表示電池目前正在卸載。 - BATTERY_POWER_ON_LINE
- 0x00000001
表示系統可以存取 AC 電源，因此不會耗盡電池。 -
容量
-
目前電池容量，以 mWh (或相對) 為單位。 此值可用來產生「油量測計」顯示，方法是將它除以BATTERY_INFORMATION結構的FullChargedCapacity成員。 如果容量無法使用，此成員會BATTERY_UNKNOWN_CAPACITY。
-
電壓
-
電池終端機的目前電池電壓，以 millivolts (mv) 。 如果電壓無法使用，此成員會BATTERY_UNKNOWN_VOLTAGE。
-
費率
-
電池計量或電池計量的目前速率。 此值會以毫秒為單位，除非電池速率資訊是相對的，在此情況下，它會以每小時任意單位為單位。 若要判斷電池資訊是否相對，請檢查BATTERY_INFORMATION結構 之 Capabilities 成員中的 BATTERY_CAPACITY_RELATIVE 旗標。 非零的正率表示充電;負率表示卸載。 某些電池只會報告充電速率。 如果費率無法使用，此成員會BATTERY_UNKNOWN_RATE。 如果電池或電源的狀態變更，速率可能會變成可用。
備註
此結構的 PowerState 成員中的BATTERY_CRITICAL旗標表示硬體「電池關鍵」狀況。 此關鍵等級是由電池製造商所設定，而不是由「重大電池警示」中的使用者所設定。這通常表示電池系統已計算出電池已完全清空，而且所繪製的任何電源都超出預期。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2003 [僅限傳統型應用程式] |
| 標頭 |
|