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項目總數是由DeviceIoControllpBytesReturned 參數值表示。 若要判斷陣列中的項目數目,請將 lpBytesReturned 的值除以 BATTERY_REPORTING_SCALE 結構的大小。 可以傳回的陣列項目數目上限為四個。

規格需求

需求
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
標頭 winnt.h (包含 Windows.h)

另請參閱

IOCTL_BATTERY_QUERY_INFORMATION

IOCTL_BATTERY_QUERY_STATUS