winnt.h) (BATTERY_REPORTING_SCALE 结构

  • 项目

包含 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返回的容量读数的粒度（以毫瓦时 (mWh) 为单位）。 随着电池放电和充电降低读数范围，粒度可能会随时间而变化。

Capacity

粒度的容量上限。 Granularity 的值对于IOCTL_BATTERY_QUERY_STATUS报告的容量有效，这些容量小于或等于此容量 (mWh) ，但大于或等于上一个数组元素中给定的容量;如果这是第一个数组元素，则为零。

注解

从 IOCTL_BATTERY_QUERY_INFORMATION 返回的BATTERY_REPORTING_SCALE项总数由 DeviceIoControl 的 lpBytesReturned 参数的值指示。 若要确定数组中的元素数，请将 lpBytesReturned 的值除以 BATTERY_REPORTING_SCALE 结构的大小。 可返回的最大数组条目数为 4。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
标头 winnt.h (包括 Windows.h)

另请参阅

IOCTL_BATTERY_QUERY_INFORMATION

IOCTL_BATTERY_QUERY_STATUS