Share via

структура BATTERY_REPORTING_SCALE (winnt.h)

  • Статья

Содержит степень детализации емкости батареи, о чем сообщает IOCTL_BATTERY_QUERY_STATUS. Массив BATTERY_REPORTING_SCALE структур переменной длины возвращается из IOCTL_BATTERY_QUERY_INFORMATION , если параметру InformationLevel присвоено значение BatteryGranularityInformation. Если степень детализации зависит от текущей емкости батареи, возвращается несколько записей.

Синтаксис

typedef struct {
  DWORD Granularity;
  DWORD Capacity;
} BATTERY_REPORTING_SCALE, *PBATTERY_REPORTING_SCALE;

Члены

Granularity

Степень детализации показаний емкости, возвращаемых IOCTL_BATTERY_QUERY_STATUS в милливатт-часах (мВт/ч). Степень детализации может меняться со временем, так как разрядка батареи и перезарядка снижают диапазон значений.

Capacity

Верхний предел емкости для гранулярности. Значение Granularity допустимо для емкостей, сообщаемых IOCTL_BATTERY_QUERY_STATUS , которые меньше или равны этой емкости (мВт-ч), но больше или равно емкости, заданной в предыдущем элементе массива, или ноль, если это первый элемент массива.

Комментарии

Общее количество BATTERY_REPORTING_SCALE записей, возвращаемых из IOCTL_BATTERY_QUERY_INFORMATION , обозначается значением параметра lpBytesReturnedобъекта DeviceIoControl. Чтобы определить количество элементов в массиве, разделите значение lpBytesReturned на размер структуры BATTERY_REPORTING_SCALE . Максимальное число записей массива, которые могут быть возвращены, равно четырем.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть winnt.h (включая Windows.h)

См. также раздел

IOCTL_BATTERY_QUERY_INFORMATION

IOCTL_BATTERY_QUERY_STATUS