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

Статья
06/03/2023

Класс CIM_MediaAccessDevice представляет возможность доступа к одному или нескольким носителям, а затем использовать его для хранения и извлечения данных.

Важно!

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

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

Синтаксис

[Abstract, UUID("{8502C52A-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class CIM_MediaAccessDevice : 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   Capabilities[];
  string   CapabilityDescriptions[];
  string   CompressionMethod;
  uint64   DefaultBlockSize;
  string   ErrorMethodology;
  uint64   MaxBlockSize;
  uint64   MaxMediaSize;
  uint64   MinBlockSize;
  boolean  NeedsCleaning;
  uint32   NumberOfMediaSupported;
};

Члены

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

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

Методы

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

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

Свойства

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

Доступность

Тип данных: 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)

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

Capabilities

Тип данных: массив uint16
Тип доступа: только для чтения
Квалификаторы: ArrayType ("Indexed"), MappingStrings ("MIF. DMTF| Запоминаные устройства|001.9", "MIF. DMTF| Запоминаные устройства|001.11", "MIF. DMTF| Запоминаные устройства|001.12", "MIF. DMTF| Disks|003.7"), ModelCorrespondence ("CIM_MediaAccessDevice. Описание возможностей")

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

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

Неизвестна.

Другое (1)

Другое

Последовательный доступ (2)

Последовательный доступ.

Случайный доступ (3)

Произвольный доступ.

Поддерживает запись (4)

Запись.

Шифрование (5)

Шифрование.

Сжатие (6)

Сжатие.

Поддерживается съемный носитель (7)

Съемный носитель.

Ручная очистка (8)

Ручная очистка.

Автоматическая очистка (9)

Автоматическая очистка.

УВЕДОМЛЕНИЕ SMART (10)

СМАРТ-уведомление.

Поддерживается двусторонний носитель (11)

Двусторонний носитель.

Отличает устройство, которое может получить доступ к обеим сторонам двустороннего носителя, от устройства, которое считывает только одну сторону и требует, чтобы носитель был перевернут.

Predismount Eject Not Required (12)

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

Описания возможностей

Тип данных: строковый массив
Тип доступа: только для чтения
Квалификаторы: ArrayType ("Indexed"), ModelCorrespondence ("CIM_MediaAccessDevice. Возможности")

Массив строк свободной формы, который содержит подробные объяснения функций устройств доступа, указанных в массиве Возможностей .

Примечание

Каждая запись этого массива связана с записью в массиве Capabilities , расположенном по тому же индексу.

Caption

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

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

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

CompressionMethod

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

Строка свободной формы, указывающая алгоритм или средство, используемое для сжатия логического файла. Если невозможно описать схему сжатия (поскольку она неизвестна), используйте следующую команду:If , используйте "Unknown". Если задано значение , используйте "Сжатый". , используйте параметр "Не сжатый".

"Неизвестно"

Схема сжатия неизвестна или не описана.

"Сжатый"

Логический файл сжимается, но схема сжатия неизвестна или не описана.

"Не сжатый"

Если логический файл не сжат

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.

DefaultBlockSize

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

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

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

Описание

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

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

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

DeviceID

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

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

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

ErrorCleared

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

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

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

ErrorDescription

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

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

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

ErrorMethodology

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

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

InstallDate

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

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

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

LastErrorCode

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

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

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

MaxBlockSize

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

Максимальный размер блока (в байтах) для мультимедиа, к которым обращается устройство.

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

MaxMediaSize

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

Максимальный размер (в килобайтах) носителя, поддерживаемого этим устройством. Килобайты интерпретируются как число байтов, умноженных на 1000 (а не число байтов, умноженное на 1024).

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

MinBlockSize

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

Минимальный размер блока (в байтах) для мультимедиа, к которым обращается устройство.

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

имя;

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

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

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

NeedsCleaning

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

Если значение РАВНО TRUE, устройство доступа к мультимедиа требует очистки. Возможность ручной или автоматической очистки указывается в свойстве массива Capabilities .

NumberOfMediaSupported

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

Максимальное количество отдельных носителей, которые можно поддерживать или вставлять.

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.

Состояние

Тип данных: 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.

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

Требования

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

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

CIM_LogicalDevice

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

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

Синтаксис

Члены

Методы

Свойства

Комментарии

Требования

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

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

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