Класс CIM_Battery

Статья
06/13/2023

Класс CIM_Battery представляет возможности логического устройства батареи и управления ими. Этот класс относится к батареям в ноутбуках и другим внутренним и внешним батареям.

Важно!

Классы CIM (Common Information Model) DMTF (Distributed Management Task Force) являются родительскими классами, на основе которых создаются классы WMI. В настоящее время WMI поддерживает только схемы версии CIM 2.x.

Приведенный ниже синтаксис является упрощенной версией кода MOF и включает все унаследованные свойства. Свойства перечислены в алфавитном порядке, а не в порядке MOF.

Синтаксис

[Abstract, UUID("{8502C548-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class CIM_Battery : CIM_LogicalDevice
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  uint16   Availability;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   DeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  ErrorCleared;
  string   ErrorDescription;
  uint32   LastErrorCode;
  string   PNPDeviceID;
  boolean  PowerManagementSupported;
  uint16   StatusInfo;
  string   SystemCreationClassName;
  string   SystemName;
  uint16   BatteryStatus;
  uint16   Chemistry;
  uint32   DesignCapacity;
  uint64   DesignVoltage;
  uint16   EstimatedChargeRemaining;
  uint32   EstimatedRunTime;
  uint32   ExpectedLife;
  uint32   FullChargeCapacity;
  uint32   MaxRechargeTime;
  string   SmartBatteryVersion;
  uint32   TimeOnBattery;
  uint32   TimeToFullCharge;
};

Члены

Класс CIM_Battery имеет следующие типы членов:

Методы
Свойства

Методы

Класс CIM_Battery содержит следующие методы.

Метод	Описание
Reset	Запрашивает сброс логического устройства. Не реализован инструментарием WMI.
SetPowerState	Определяет требуемое состояние питания для логического устройства и время, когда устройство должно быть переведено в это состояние. Не реализован инструментарием WMI.

Свойства

Класс CIM_Battery имеет следующие свойства.

Доступность

Тип данных: uint16
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| Рабочее состояние|003.5", "MIB. IETF| HOST-RESOURCES-MIB.hrDeviceStatus")

Доступность и состояние устройства.

Это свойство наследуется от CIM_LogicalDevice.

Другое (1)

Неизвестно (2)

Работает/полная мощность (3)

Предупреждение (4)

В тесте (5)

Неприменимо (6)

Выключение питания (7)

Off Line (8)

Off Duty (9)

Пониженная производительность (10)

Не установлено (11)

Ошибка установки (12)

Энергосбережение — неизвестно (13)

Известно, что устройство находится в режиме энергопотребления, но его точное состояние неизвестно.

Экономия энергии — режим низкого энергопотребления (14)

Устройство находится в состоянии экономии электроэнергии, но по-прежнему работает и может демонстрировать снижение производительности.

Экономия энергии в режиме ожидания (15)

Устройство не работает, но может быть быстро приведено в полную мощность.

Цикл питания (16)

Экономия энергии — предупреждение (17)

Устройство находится в состоянии предупреждения, но также в режиме энергопотребления.

Приостановлено (18)

Устройство приостановлено.

Не готово (19)

Устройство не готово.

Не настроено (20)

Устройство не настроено.

Заморозка (21)

Устройство не работает.

BatteryStatus

Тип данных: uint16
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| Портативный аккумулятор|002.14")

Описание состояния заряда батареи. Значение 10 недопустимо в схеме CIM, которая представляет отсутствие батареи, установленной в интерфейсе управления рабочими столами (DMI). В этом случае экземпляр объекта не должен создаваться.

Другое (1)

Другое

Неизвестно (2)

Неизвестна.

Полностью заряженный (3)

Полностью заряжена.

Низкий (4)

Низкий.

Критический (5)

Критическое —

Зарядка (6)

Зарядки.

Зарядка и высокая (7)

Зарядка и высокая.

Зарядка и низкий уровень (8)

Зарядка и низкий.

Зарядка и критическое значение (9)

Зарядка и критическая.

Не определено (10)

Не определено.

Частично оплачивается (11)

Частично взимается плата.

Caption

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (64), DisplayName ("Caption")

Краткое текстовое описание объекта.

Это свойство наследуется от CIM_ManagedSystemElement.

Химии

Тип данных: uint16
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| Портативный аккумулятор|002.7")

Перечисление, описывающее химию батареи.

Другое (1)

Другое

Неизвестно (2)

Неизвестна.

Свинцовая кислота (3)

Свинцовая кислота.

Никель кадмий (4)

Никель кадмий.

Никель металлгидрид (5)

Никель металл hydride.

Литиево-ионный (6)

Ион лития.

Цинковый воздух (7)

Цинковый воздух.

Литиево-смоляный ( 8)

Литиевая смола.

ConfigManagerErrorCode

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: Схема ("Win32")

Код ошибки Configuration Manager Win32.

Это свойство наследуется от CIM_LogicalDevice.

Это устройство работает правильно. (0)

Это устройство настроено неправильно. (1)

Windows не может загрузить драйвер для этого устройства. (2)

Драйвер для этого устройства может быть поврежден, или в системе может быть недостаточно памяти или других ресурсов. (3)

Это устройство работает неправильно. Возможно, поврежден один из драйверов или реестра. (4)

Драйверу для этого устройства требуется ресурс, которым Windows не может управлять. (5)

Конфигурация загрузки этого устройства конфликтует с другими устройствами. (6)

Не удается выполнить фильтрацию. (7)

Отсутствует загрузчик драйверов для устройства. (8)

Это устройство работает неправильно, так как управляющее встроенное ПО неправильно сообщает о ресурсах для устройства. (9)

Это устройство не может запуститься. (10)

Это устройство завершилось сбоем. (11)

Это устройство не может найти достаточно свободных ресурсов, которые оно может использовать. (12)

Windows не может проверить ресурсы этого устройства. (13)

Это устройство не может работать должным образом, пока вы не перезагрузите компьютер. (14)

Это устройство работает неправильно, так как, вероятно, возникла проблема с повторным перечислением. (15)

Windows не может определить все ресурсы, используемые этим устройством. (16)

Это устройство запрашивает неизвестный тип ресурса. (17)

Переустановите драйверы для этого устройства. (18)

Сбой при использовании загрузчика VxD. (19)

Возможно, реестр поврежден. (20)

Сбой системы. Попробуйте изменить драйвер для этого устройства. Если это не сработает, см. документацию по оборудованию. Windows удаляет это устройство. (21)

Это устройство отключено. (22)

Сбой системы. Попробуйте изменить драйвер для этого устройства. Если это не сработает, см. документацию по оборудованию. (23)

Это устройство отсутствует, работает неправильно или на нем установлены не все драйверы. (24)

Windows по-прежнему настраивает это устройство. (25)

Windows по-прежнему настраивает это устройство. (26)

Это устройство не имеет допустимой конфигурации журнала. (27)

Драйверы для этого устройства не установлены. (28)

Это устройство отключено, так как встроенное ПО устройства не предоставляет ему необходимые ресурсы. (29)

Это устройство использует ресурс запроса прерывания (IRQ), который использует другое устройство. (30)

Это устройство работает неправильно, так как Windows не может загрузить драйверы, необходимые для этого устройства. (31)

ConfigManagerUserConfig

Тип данных: boolean
Тип доступа: только для чтения
Квалификаторы: Схема ("Win32")

Если задано значение TRUE, устройство использует определяемую пользователем конфигурацию.

Это свойство наследуется от CIM_LogicalDevice.

CreationClassName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: CIM_Key

Имя класса или подкласса, используемого при создании экземпляра. При использовании с другими ключевыми свойствами класса это свойство позволяет уникально идентифицировать все экземпляры класса и его подклассы.

Это свойство наследуется от CIM_LogicalDevice.

Описание

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: DisplayName ("Описание")

Текстовое описание объекта.

Это свойство наследуется от CIM_ManagedSystemElement.

DesignCapacity

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| Портативный аккумулятор|002.8"), единицы измерения (милливатт-часы)

Рассчитанная емкость аккумулятора в милливатт-часах. Если это свойство не поддерживается, введите 0.

DesignVoltage

Тип данных: uint64
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| Портативный аккумулятор|002.9"), единицы измерения ("милливольты")

Рассчитанное напряжение батареи в милливольтах. Если этот атрибут не поддерживается, введите 0.

Дополнительные сведения об использовании значений uint64 в скриптах см. в разделе Создание скриптов в WMI.

DeviceID

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: CIM_Key

Адрес или другие идентифицирующие сведения для уникального имени логического устройства.

Это свойство наследуется от CIM_LogicalDevice.

ErrorCleared

Тип данных: boolean
Тип доступа: только для чтения

Если задано значение TRUE, ошибка, обнаруженная в свойстве LastErrorCode , теперь очищается.

Это свойство наследуется от CIM_LogicalDevice.

ErrorDescription

Тип данных: string
Тип доступа: только для чтения

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

Это свойство наследуется от CIM_LogicalDevice.

EstimatedChargeRemaining

Тип данных: uint16
Тип доступа: только для чтения
Квалификаторы: единицы ("проценты")

Предполагаемый процент оставшейся полной оплаты.

EstimatedRunTime

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| Портативный аккумулятор|002.15"), единицы измерения ("минуты")

Предполагаемое время (в минутах) до тех пор, пока заряд батареи не будет исчерпан при нынешних условиях нагрузки, если питание служебной программы отключено, потеряется и остается отключенным или если ноутбук отключен от источника питания.

ExpectedLife

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: единицы ("минуты")

Ожидаемое время существования батареи (в минутах) при условии, что аккумулятор полностью заряжен. Это свойство представляет собой общий ожидаемый срок службы батареи, а не его текущий оставшийся срок службы, который указывается свойством EstimatedRunTime .

FullChargeCapacity

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| Портативный аккумулятор|002.11"), единицы измерения (милливатт-часы)

Полная емкость заряда батареи в милливатт-часах. Сравните это значение со свойством DesignCapacity , чтобы определить, когда требуется замена аккумулятора. Срок службы батареи обычно происходит, когда свойство FullChargeCapacity опускается ниже 80 процентов от свойства DesignCapacity . Если это свойство не поддерживается, введите 0.

InstallDate

Тип данных: datetime
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Дата установки")

Указывает, когда был установлен объект . Отсутствие значения не означает, что объект не установлен.

Это свойство наследуется от CIM_ManagedSystemElement.

LastErrorCode

Тип данных: uint32
Тип доступа: только для чтения

Последний код ошибки, сообщаемый логическим устройством.

Это свойство наследуется от CIM_LogicalDevice.

MaxRechargeTime

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: единицы ("минуты")

Максимальное время (в минутах) для полной зарядки батареи. Это свойство представляет время зарядки полностью исчерпанной батареи, а не текущее оставшееся время зарядки, указанное в свойстве TimeToFullCharge .

имя;

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: DisplayName ("Имя")

Метка, по которой известен объект. При создании подкласса это свойство может быть переопределено как ключевое свойство.

Это свойство наследуется от CIM_ManagedSystemElement.

PNPDeviceID

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Schema ("Win32")

Указывает идентификатор логического устройства Plug and Play Win32.

Пример: "*PNP030b"

Это свойство наследуется от CIM_LogicalDevice.

PowerManagementCapabilities

Тип данных: массив uint16
Тип доступа: только для чтения

Указывает конкретные возможности логического устройства, связанные с питанием.

Это свойство наследуется от CIM_LogicalDevice.

Неизвестно (0)

Емкости, связанные с питанием, неизвестны.

Не поддерживается (1)

Емкости, связанные с питанием, не поддерживаются для этого устройства.

Отключено (2)

Емкости, связанные с питанием, отключены.

Включено (3)

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

Режимы энергосбережения, введенные автоматически (4)

Устройство может изменять состояние питания в зависимости от использования или других критериев.

Настройка состояния power (5)

Поддерживается метод SetPowerState . Этот метод находится в родительском CIM_LogicalDevice классе и может быть реализован. Дополнительные сведения см. в разделе Designing Managed Object Format (MOF) Classes.

Поддержка циклов питания (6)

Метод SetPowerState можно вызвать с параметром PowerState , равным 5 ("Power Cycle").

Поддержка включения по времени (7)

Метод SetPowerState можно вызвать с параметром PowerState , равным 5 ("Power Cycle"), а для параметра Time задана определенная дата и время или интервал для включения питания.

PowerManagementSupported

Тип данных: boolean
Тип доступа: только для чтения

Если задано значение TRUE, устройством можно управлять питанием, то есть переводить в состояние экономии энергии. Если значение FALSE, целочисленное значение 1 ("Не поддерживается") должно быть единственной записью в массиве PowerManagementCapabilities .

Это свойство не указывает, включены ли в настоящее время функции управления питанием или, если они включены, какие функции поддерживаются. Дополнительные сведения см. в статье Массив PowerManagementCapabilities .

Это свойство наследуется от CIM_LogicalDevice.

SmartBatteryVersion

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (64), MappingStrings ("MIF. DMTF| Портативный аккумулятор|002.10")

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

Состояние

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (10), DisplayName ("Status")

Строка, указывающая текущее состояние объекта. Можно определить рабочее и нерабочем состояние. Состояние работы может включать "ОК", "Понижено" и "Сбой предварительного выполнения". "Pred Fail" означает, что элемент работает правильно, но прогнозирует сбой (например, жесткий диск с поддержкой SMART).

Состояние нерабоспособных может включать "Ошибка", "Запуск", "Остановка" и "Служба". "Служба" может применяться во время зеркало повторного изменения размера диска, перезагрузки списка разрешений пользователя или других административных действий. Не все такие работы доступны в сети, но управляемый элемент не является ни "ОК", ни в одном из других состояний.

Это свойство наследуется от CIM_ManagedSystemElement.

В эти значения входят:

ОК ("ОК")

Ошибка ("Ошибка")

Пониженный ("Пониженный")

Unknown ("Unknown")

Pred Fail ("Pred Fail")

Запуск ("Начало")

Остановка ("Остановка")

Служба ("Служба")

Подчеркнуто ("Подчеркнуто")

NonRecover ("NonRecover")

Нет контакта ("Нет контакта")

Lost Comm ("Lost Comm")

StatusInfo

Тип данных: uint16
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| Рабочее состояние|003.3")

Состояние логического устройства. Если это свойство не применяется к логическому устройству, следует использовать значение 5 ("Неприменимо").

Это свойство наследуется от CIM_LogicalDevice.

Другое (1)

Неизвестно (2)

Включено (3)

Отключено (4)

Неприменимо (5)

SystemCreationClassName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: распространяется ("CIM_System. CreationClassName"), CIM_Key

Имя класса создания системы области.

Это свойство наследуется от CIM_LogicalDevice.

SystemName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: распространяется ("CIM_System. Name"), CIM_Key

Имя системы определения области.

Это свойство наследуется от CIM_LogicalDevice.

TimeOnBattery

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: единицы ("секунды")

Затраченное время (в секундах) с момента последнего переключения ИП компьютера на питание от батареи или время с момента последней перезагрузки системы или ИП, в зависимости от того, что меньше. Если аккумулятор подключен к сети, возвращается значение 0.

TimeToFullCharge

Тип данных: uint32
Тип доступа: только для чтения
Квалификаторы: MappingStrings ("MIF. DMTF| Портативный аккумулятор|002.16"), единицы измерения ("минуты")

Оставшееся время (в минутах) для полной зарядки батареи с текущей скоростью зарядки и использования.

Эта документация является производным от описаний классов CIM, опубликованных DMTF. Возможно, корпорация Майкрософт внесла изменения для исправления незначительных ошибок, соответствия стандартам документации по Microsoft SDK или предоставления дополнительных сведений.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Пространство имен	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

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

CIM_LogicalDevice

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

Класс CIM_Battery

Синтаксис

Члены

Методы

Свойства

Комментарии

Требования

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

Обратная связь

Дополнительные ресурсы