Поделиться через

структура 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
 Указывает, что система имеет доступ к энергопотреблению переменного тока, поэтому батареи не разряжаются.

Производительность

Текущая емкость аккумулятора в мВт*ч (или относительно). Это значение можно использовать для создания индикатора газа, разделив его на элемент FullChargedCapacityBATTERY_INFORMATION структуры. Если емкость недоступна, этот элемент BATTERY_UNKNOWN_CAPACITY.

Напряжение

Текущее напряжение батареи в разъемах аккумулятора в милливольтах (мv). Если напряжение недоступно, этот элемент BATTERY_UNKNOWN_VOLTAGE.

Тариф

Текущая скорость заряда или разрядки батареи. Это значение будет в милливаттах, если сведения о частоте заряда батареи не являются относительными. В этом случае оно будет находиться в произвольных единицах в час. Чтобы определить, являются ли сведения о батарее относительными, проверьте флаг BATTERY_CAPACITY_RELATIVE в элементе Capabilities структуры BATTERY_INFORMATION . Ненулевое положительное значение указывает на зарядку; отрицательная скорость указывает на разрядку. Некоторые батареи сообщают только о скорости разрядки. Если тариф недоступен, этот элемент BATTERY_UNKNOWN_RATE. Если состояние батареи или источника питания изменится, скорость может стать доступной.

Комментарии

Флаг BATTERY_CRITICAL в элементе PowerState этой структуры указывает на "критическое" состояние оборудования. Этот критический уровень устанавливается производителем батареи, а не пользователем в "критическом оповещении батареи". Как правило, это означает, что система батареи подсчитала, что батарея полностью разрядилась, и любая заряжаемая мощность выходит за пределы ожидаемого.

Требования

Требование Значение
Минимальная версия клиента
 Windows XP [только классические приложения]
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
Заголовок
Poclass.h;
Batclass.h в Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP

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

BATTERY_INFORMATION

IOCTL_BATTERY_QUERY_STATUS