класс CIM_LogicalDevice (поставщики WMI CIMWin32)

Статья
09/22/2022
Чтение занимает 7 мин

Класс CIM_LogicalDevice представляет сущность оборудования, которая может быть реализована в физическом оборудовании.

Важно!

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

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

Синтаксис

[Abstract, UUID("{8502C529-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class CIM_LogicalDevice : CIM_LogicalElement
{
  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;
};

Участники

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

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

Методы

Класс CIM_LogicalDevice имеет эти методы.

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

Свойства

Класс CIM_LogicalDevice имеет эти свойства.

Доступность

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

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

Другое (1)

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

Запуск и полная мощность (3)

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

В тесте (5)

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

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

Off Line (8)

Off Duty (9)

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

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

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

Power Save — неизвестно (13)

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

Power Save — режим низкой мощности (14)

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

Power Save — резервный (15)

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

Power Cycle (16)

Power Save — предупреждение (17)

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

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

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

Не готово (19)

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

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

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

Заморозили (21)

Устройство тихо.

Caption

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

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

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

ConfigManagerErrorCode

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

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

Это устройство работает правильно. (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

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

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

CreationClassName

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

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

Описание

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

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

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

Идентификатор устройства

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

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

ОшибкаCleared

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

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

ErrorDescription

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

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

InstallDate

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

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

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

LastErrorCode

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

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

Имя

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

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

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

PNPDeviceID

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

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

Пример: "*PNP030b"

PowerManagementCapabilities

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

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

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

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

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

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

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

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

Включено (3)

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

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

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

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

Поддерживается метод SetPowerState . Этот метод найден в родительском CIM_LogicalDevice классе и может быть реализован. Дополнительные сведения см. в разделе "Проектирование классов формата управляемых объектов ( MOF).

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

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

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

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

PowerManagementSupported

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

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

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

Состояние

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

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

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

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

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

ОК ("ОК")

Error ("Error")

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

Unknown ("Unknown")

Pred Fail ("Pred Fail")

Запуск ("Запуск")

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

Service ("Service")

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

NonRecover ("NonRecover")

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

Lost Comm ("Lost Comm")

StatusInfo

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

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

Другое (1)

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

Включено (3)

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

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

SystemCreationClassName

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

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

SystemName

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

Имя системы области.

Remarks

Характеристики логического устройства, управляющие операцией или конфигурацией, содержатся в объекте CIM_LogicalDevice или связаны с ним. Операционные свойства принтера, например, поддерживают размеры бумаги или обнаруженные ошибки. Например, свойства конфигурации устройства датчика являются параметрами порогового значения. Различные конфигурации могут существовать для логического устройства и содержатся в объектах CIM_Setting , связанных с логическим устройством.

Класс CIM_LogicalDevice является производным от CIM_LogicalElement.

WMI не реализует этот класс. Сведения о классах, производных от CIM_LogicalDevice, см. в разделе "Классы Win32".

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

Требования

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

См. также

CIM_LogicalElement

класс CIM_LogicalDevice (поставщики WMI CIMWin32)

Синтаксис

Участники

Методы

Свойства

Remarks

Требования

См. также

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

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