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

структура BATTERY_SET_INFORMATION

  • Статья

Содержит сведения о батарее, которые необходимо задать. Эта структура используется с кодом элемента управления IOCTL_BATTERY_SET_INFORMATION .

Синтаксис

typedef struct _BATTERY_SET_INFORMATION {
  ULONG                         BatteryTag;
  BATTERY_SET_INFORMATION_LEVEL InformationLevel;
  UCHAR                         Buffer[1];
} BATTERY_SET_INFORMATION, *PBATTERY_SET_INFORMATION;

Члены

BatteryTag

Текущий тег батареи для батареи. Сведения о батарее, соответствующей тегу, могут быть возвращены только. Если это значение не совпадает с текущим тегом батареи, запрос IOCTL будет завершен с помощью ERROR_FILE_NOT_FOUND, который указывает вызывающему объекту, что батарея, для которой у него есть тег , больше не существует. Вызывающий объект может использовать операцию IOCTL_BATTERY_QUERY_TAG для определения тега только что установленного аккумулятора, если он существует. (Дополнительные сведения см. в разделе Теги батареи .)

При запросе сведений о запросе это значение проверяется. Кроме того, если запрос выполняется при изменении этого значения, запрос прерывается с состоянием ERROR_FILE_NOT_FOUND.

InformationLevel

Сведения о батарее, которые необходимо задать. Тип данных в элементе Buffer зависит от значения этого элемента. Этот элемент может иметь одно из следующих значений.

Значение Значение
BatteryCharge
1
 Сообщает устройству батареи о том, что пользователь запросил, что батарея должна заряжаться в данный момент. Например, с помощью смарт-аккумулятора, зарядного устройства или селектора приложение может заряжать по одной батарее за раз. Элемент Buffer этой структуры игнорируется.
BatteryCriticalBias
0
 Задает настройку критического смещения батареи. Обратите внимание, что это значение обычно изменяется программным обеспечением и присутствует в интерфейсах только в качестве функции обслуживания. Не все батареи могут поддерживать такой параметр, и сведения об аккумуляторе должны быть прочитаны, чтобы убедиться, что аккумулятор принял этот параметр.
BatteryDischarge
2
 Сообщает устройству батареи о том, что пользователь запросил разрядку батареи в данный момент. Например, это можно использовать для указания того, какой аккумулятор пользователь в настоящее время хочет включить систему. Элемент Buffer этой структуры игнорируется.

Буфер

Сведения о батарее, которые необходимо задать. Данные зависят от значения InformationLevel.

Комментарии

Структура BATTERY_SET_INFORMATION является структурой переменной длины, и необходимо выделить буфер подходящего размера для включения информации в структуру.

Требования

Требование Значение
Минимальная версия клиента
 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

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

IOCTL_BATTERY_SET_INFORMATION