BATTERY_REPORTING_SCALE結構 (winnt.h)
包含 IOCTL_BATTERY_QUERY_STATUS所報告的電池容量粒度。 當 InformationLevel 設定為 BatteryGranularityInformation 時,會從IOCTL_BATTERY_QUERY_INFORMATION傳回BATTERY_REPORTING_SCALE結構的可變長度陣列。 當粒度取決於電池的目前容量時,會傳回多個專案。
語法
typedef struct {
DWORD Granularity;
DWORD Capacity;
} BATTERY_REPORTING_SCALE, *PBATTERY_REPORTING_SCALE;
成員
Granularity
IOCTL_BATTERY_QUERY_STATUS 以 milliwatt-hours (mWh) 傳回的容量讀數粒度。 數據粒度可能會隨著時間而改變,因為電池電量和充電量會降低讀數的範圍。
Capacity
數據粒度的容量上限。 Granularity 的值適用於小於或等於此容量的容量,IOCTL_BATTERY_QUERY_STATUS小於或等於此容量 (mWh) ,但大於或等於上一個陣列元素中指定的容量,如果這是第一個數位元素,則為零。
備註
從 IOCTL_BATTERY_QUERY_INFORMATION 傳回的BATTERY_REPORTING_SCALE項目總數是由DeviceIoControl的 lpBytesReturned 參數值表示。 若要判斷陣列中的項目數目,請將 lpBytesReturned 的值除以 BATTERY_REPORTING_SCALE 結構的大小。 可以傳回的陣列項目數目上限為四個。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
標頭 | winnt.h (包含 Windows.h) |