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

Статья
03/08/2023

Содержит сведения о текущем состоянии системного аккумулятора.

Синтаксис

typedef struct {
  BOOLEAN AcOnLine;
  BOOLEAN BatteryPresent;
  BOOLEAN Charging;
  BOOLEAN Discharging;
  BOOLEAN Spare1[3];
  BYTE    Tag;
  DWORD   MaxCapacity;
  DWORD   RemainingCapacity;
  DWORD   Rate;
  DWORD   EstimatedTime;
  DWORD   DefaultAlert1;
  DWORD   DefaultAlert2;
} SYSTEM_BATTERY_STATE, *PSYSTEM_BATTERY_STATE;

Члены

AcOnLine

Если этот элемент имеет значение TRUE, то зарядное устройство системы в настоящее время работает от внешнего питания.

BatteryPresent

Если этот элемент имеет значение TRUE, в системе присутствует хотя бы один аккумулятор.

Charging

Если этот элемент имеет значение TRUE, аккумулятор в настоящее время заряжается.

Discharging

Если этот элемент имеет значение TRUE, батарея в настоящее время разрядится.

Spare1[3]

Зарезервировано.

Tag

MaxCapacity

Теоретическая емкость батареи при создании.

RemainingCapacity

Предполагаемая оставшаяся емкость батареи.

Rate

Текущая скорость разряда батареи в мВт. Ненулевое положительное значение указывает на оплату; отрицательная скорость указывает на разрядку. Некоторые батареи сообщают только о скорости разрядки. Это значение должно рассматриваться как LONG , так как оно может содержать отрицательные значения (с большим набором битов).

EstimatedTime

Предполагаемое время, оставшееся на батарее, в секундах.

DefaultAlert1

Предложение изготовителя о емкости в мВт/ч, при которой должно возникать оповещение о низком заряде батареи. Определения низкого уровня зависят от производителя. Как правило, состояние предупреждения будет возникать до низкого состояния, но не следует предполагать, что оно будет всегда. Чтобы снизить риск потери данных, это значение обычно используется в качестве параметра по умолчанию для критической сигнализации батареи.

DefaultAlert2

Предложение изготовителем емкости в мВт-ч, при которой должно появляться предупреждение батареи. Определения предупреждений зависят от производителя. Как правило, состояние предупреждения будет возникать до низкого состояния, но не следует предполагать, что оно будет всегда. Чтобы снизить риск потери данных, это значение обычно используется в качестве параметра по умолчанию для оповещения о низком заряде батареи.

Требования


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

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

CallNtPowerInformation

Share via