Класс Msvm_DVDDrive

Статья
06/12/2023

Представляет DVD-диск в виртуальной машине. Этот DVD-диск может быть устройством сквозной передачи (если к виртуальной машине был подключен физический жесткий диск) или искусственным и заполнен файловыми носителями ISO. Так как виртуальные и физические DVD-диски можно добавлять и удалять с виртуальной машины, с этим классом связаны два пула ресурсов: один для сквозных DVD-дисков, а другой — для виртуальных DVD-дисков. DVD-диски можно добавлять или удалять, только если виртуальная машина находится в автономном режиме.

Следующий синтаксис представляет собой упрощенный код формата управляемого объекта (MOF) и включает все унаследованные свойства.

Синтаксис

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_DVDDrive : CIM_DVDDrive
{
  string   InstanceID;
  string   Caption = "DVD Drive";
  string   Description = "Microsoft Virtual DVD Drive";
  string   ElementName = "DVD Drive";
  datetime InstallDate;
  string   Name = "DVD Drive";
  uint16   OperationalStatus[] = { 2 };
  string   StatusDescriptions[] = { "OK" };
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 5;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  uint16   CreationClassName = "Msvm_DVDDrive";
  string   DeviceID = "Microsoft:GUID\device-specific-data";
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability = 6;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[] = 6;
  uint64   MaxQuiesceTime;
  uint32   Capabilities[] = {3, 7};
  string   CapabilityDescriptions[] = {"Random Access", "Supports Removable Media"};
  string   ErrorMethodology = "None";
  string   CompressionMethod = "Not Compressed";
  uint32   NumberOfMediaSupported = 1;
  uint64   MaxMediaSize = 9400000;
  uint64   DefaultBlockSize = 2048;
  uint64   MaxBlockSize = 2048;
  uint64   MinBlockSize = 2048;
  boolean  NeedsCleaning = False;
  boolean  MediaIsLocked = False;
  uint16   Security = 3;
  datetime LastCleaned;
  uint64   MaxAccessTime = 0;
  uint32   UncompressedDataRate;
  uint64   LoadTime = 0;
  uint64   UnloadTime = 0;
  uint64   MountCount = 0;
  datetime TimeOfLastMount;
  uint64   TotalMountTime = 0;
  string   UnitsDescription;
  uint64   MaxUnitsBeforeCleaning = 0xffffffffffffffff;
  uint64   UnitsUsed = 0;
  uint16   FormatsSupported[] = {16, 22};
};

Члены

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

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

Методы

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

Метод	Описание
EnableDevice	Этот метод не поддерживается.
LockMedia	Блокирует или освобождает носитель.
OnlineDevice	Этот метод не поддерживается.
QuiesceDevice	Этот метод не поддерживается.
RequestStateChange	Запрашивает изменение состояния.
Reset	Сбрасывает виртуальное устройство.
RestoreProperties	Этот метод не поддерживается.
Saveproperties	Этот метод не поддерживается.
SetPowerState	Этот метод не поддерживается.

Свойства

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

AdditionalAvailability

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

Любые дополнительные сведения о доступности и состоянии устройства. Это свойство наследуется от CIM_LogicalDevice и имеет значение 6 (неприменимо).

Доступность

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

Основная доступность и состояние устройства. Это свойство наследуется от CIM_LogicalDevice и имеет значение 6 (неприменимо).

AvailableRequestedStates

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

Указывает возможные значения параметра RequestedState метода RequestStateChange , используемого для инициации изменения состояния. Перечисленные значения будут подмножеством значений, содержащихся в свойстве RequestedStatesSupported связанного экземпляра CIM_EnabledLogicalElementCapabilities, где выбранные значения являются функцией текущего состояния объекта CIM_EnabledLogicalElement . Это свойство может быть не null , если реализация может объявить набор возможных значений как функцию текущего состояния. Это свойство будет иметь значение Null , если реализация не может определить набор возможных значений как функцию текущего состояния.

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

Capabilities

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

Возможности устройства доступа к мультимедиа. Это свойство наследуется от CIM_MediaAccessDevice и имеет следующие значения.

Значение	Значение
{3, 7}
3	Соответствующая запись в CapabilityDescriptions — "Случайный доступ".
7	Соответствующая запись в CapabilityDescriptions — "Поддерживает съемные носители".

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

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

Массив строк свободной формы, предоставляющий подробные объяснения функций устройств доступа, указанных в массиве свойств Capabilities . Каждая запись этого массива связана с записью в массиве свойств Capabilities , расположенном по тому же индексу. Это свойство наследуется от CIM_MediaAccessDevice.

Caption

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

Краткое описание объекта. Это свойство наследуется от CIM_ManagedElement.

CommunicationStatus

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

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

CompressionMethod

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

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

"Не сжатый"

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

"Сжатый"

"Не сжатый"

CreationClassName

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

Имя класса или подкласса, используемого при создании экземпляра. Это свойство наследуется от CIM_LogicalDevice.

DefaultBlockSize

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

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

Описание

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

Описание объекта. Это свойство наследуется от CIM_ManagedElement.

DetailedStatus

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

Дополняет свойство PrimaryStatus дополнительными сведениями о состоянии. Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

DeviceID

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

Это свойство наследуется от CIM_LogicalDevice и имеет значение Microsoft:GUID\device-specific-data.

ElementName

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

Отображаемое имя объекта. Это свойство наследуется от CIM_ManagedElement.

EnabledDefault

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

Конфигурация по умолчанию или запуска администратора для включенного состояния элемента. Это свойство наследуется от CIM_EnabledLogicalElement.

EnabledState

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

Включенные и отключенные состояния элемента. Он также может указывать на переходы между этими запрошенными состояниями. Это свойство наследуется от CIM_EnabledLogicalElement.

ErrorCleared

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

Указывает, снята ли ошибка, сообщаемая в LastErrorCode . Это свойство наследуется от CIM_LogicalDevice, но не используется.

ErrorDescription

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

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

ErrorMethodology

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

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

Форматыподдерживаемые

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

Форматы компакт- и DVD-дисков, поддерживаемые этим устройством. Это свойство наследуется от CIM_DVDDrive.

Этот массив содержит следующие значения для ISO.

{16, 22}
Компакт-диск (16)
DVD ( 22)

Этот массив содержит следующие значения для физической сквозной передачи.

Неизвестно (0)
Другое (1)
Компакт-диск (16)
CD-ROM/XA (17)
CD-I (18)
Записываемый компакт-диск (19)
DVD ( 22)
DVD-RW+ (23)
DVD-ОЗУ (24)
DVD-ROM (25)
DVD-Видео (26)
Divx (27)
CD-RW (33)
CD-DA (34)
CD+ (35)
Записываемый DVD-диск (36)
DVD-RW (37)
DVD-Аудио (38)
DVD-5 (39)
DVD-9 (40)
DVD-10 (41)
DVD-18 (42)

HealthState

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

Текущая работоспособность элемента. Этот атрибут выражает работоспособность этого элемента, но не обязательно его подкомпонентов. Возможные значения: от 0 до 30, где 5 означает, что элемент полностью работоспособен, а 30 означает, что элемент является полностью нефункциональным. Это свойство наследуется от CIM_ManagedSystemElement.

IdentifyingDescriptions

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

Массив строк свободной формы, которые предоставляют пояснения и сведения о записях в массиве свойств OtherIdentifyingInfo . Это свойство наследуется от CIM_LogicalDevice и имеет значение Null.

InstallDate

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

Дата и время создания конфигурации виртуальной машины. Это свойство наследуется от CIM_ManagedSystemElement.

InstanceID

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

Уникально идентифицирует экземпляр этого класса. Это свойство наследуется от CIM_ManagedElement.

LastCleaned

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

Дата и время последней очистки устройства. Это свойство наследуется от CIM_MediaAccessDevice.

LastErrorCode

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

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

LoadTime

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

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

MaxAccessTime

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

Время (в миллисекундах) перехода из первого расположения на носителе в расположение, которое является самым дальним по отношению к времени. Для диска этот параметр представляет собой полный поиск и полную задержку вращения. Для ленточных накопителей это представляет собой поиск от начала ленты до наиболее физически удаленной точки. (Конец ленты может находиться в самой отдаленной физической точке, но это не обязательно так.) Это свойство наследуется от CIM_MediaAccessDevice.

MaxBlockSize

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

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

MaxMediaSize

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

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

MaxQuiesceTime

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

Это свойство использовать не рекомендуется. Это свойство наследуется от CIM_LogicalDevice, но не используется.

MaxUnitsBeforeCleaning

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

Максимальное количество единиц, которое можно использовать перед очисткой устройства. Это свойство наследуется от CIM_MediaAccessDevice.

MediaIsLocked

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

Значение true , если носитель заблокирован на устройстве и не может быть извлечен; в противном случае — False. Это свойство наследуется от CIM_MediaAccessDevice.

MinBlockSize

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

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

MountCount

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

Для устройства, поддерживающего съемный носитель, — количество раз, когда носитель был подключен для передачи данных или очистки устройства. Для устройств, обращаюющихся к неустранимым носителям, таким как жесткие диски, это свойство неприменимо и должно иметь значение 0. Это свойство наследуется от CIM_MediaAccessDevice.

имя;

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

Метка, по которой известен объект. Это свойство наследуется от CIM_ManagedSystemElement и совпадает со свойством ElementName .

NeedsCleaning

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

Значение true , если устройство доступа к мультимедиа нуждается в очистке; в противном случае — False. Это свойство наследуется от CIM_MediaAccessDevice.

NumberOfMediaSupported

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

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

OperatingStatus

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

Предоставляет текущие сведения о состоянии рабочего состояния элемента и может использоваться для предоставления дополнительных сведений о значении свойства EnabledState . Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

OperationalStatus

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

Текущие состояния объекта. Это свойство наследуется от CIM_ManagedSystemElement.

OtherEnabledState

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

Состояние enabled или disabled элемента, если свойство EnabledState имеет значение 1 (Other). Это свойство должно иметь значение Null , если свойство EnabledState имеет любое значение, отличное от 1. Это свойство наследуется от CIM_EnabledLogicalElement.

OtherIdentifyingInfo

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

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

PowerManagementCapabilities

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

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

PowerManagementSupported

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

Указывает, можно ли управлять питанием устройства. Это свойство наследуется от CIM_LogicalDevice, но не используется.

PowerOnHours

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

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

PrimaryStatus

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

Предоставляет сведения о состоянии высокого уровня. Это свойство следует использовать в сочетании со свойством DetailedStatus для предоставления высокого уровня и подробных сведений о состоянии работоспособности элемента и его подкомпонентов. Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

RequestedState

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

Последнее запрошенное или требуемое состояние элемента. Фактическое состояние элемента представлено свойством EnabledState . Это свойство предоставляется для сравнения последнего запрошенного и текущего состояний включения или отключения. Конкретный экземпляр CIM_EnabledLogicalElement может не поддерживать метод RequestStateChange . В этом случае используется значение 12 (неприменимо). Это свойство наследуется от CIM_EnabledLogicalElement.

Безопасность

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

Операционная безопасность, определенная для устройства. Это свойство наследуется от CIM_MediaAccessDevice.

Состояние

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

Текущее состояние объекта. Это свойство наследуется от CIM_ManagedSystemElement, но не используется.

Описания состояния

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

Строки, описывающие различные значения массива OperationalStatus . Это свойство наследуется от CIM_ManagedSystemElement.

StatusInfo

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

Текущее состояние логического устройства. Это свойство наследуется от CIM_LogicalDevice, но не используется.

SystemCreationClassName

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

Имя класса создания системы области. Это свойство наследуется от CIM_LogicalDevice.

SystemName

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

Уникальный идентификатор виртуальной машины с областью действия. Это свойство наследуется от CIM_LogicalDevice.

TimeOfLastMount

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

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

TimeOfLastStateChange

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

Дата или время последнего изменения включенного состояния элемента. Это свойство наследуется от CIM_EnabledLogicalElement и всегда имеет значение Null.

TotalMountTime

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

Для устройства, поддерживающего съемный носитель, — общее время (в секундах) подключения носителя для передачи данных или очистки устройства. Для устройств, обращаюющихся к неустранимым носителям, таким как жесткие диски, это свойство неприменимо и должно иметь значение 0. Это свойство наследуется от CIM_MediaAccessDevice.

TotalPowerOnHours

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

Общее количество часов питания этого устройства. Это свойство наследуется от CIM_LogicalDevice, но не используется.

TransitioningToState

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

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

UncompressedDataRate

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

Устойчивая скорость передачи данных в КБ/с, которую устройство может считывать и записывать на носитель. Это устойчивая скорость необработанных данных. В этом свойстве не следует сообщать о максимальной скорости или скорости сжатия. Это свойство наследуется от CIM_MediaAccessDevice.

Описание единиц

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

Единицы измерения относительно его использования в MaxUnitsBeforeCleaning. Это свойство наследуется от CIM_MediaAccessDevice.

UnitsUsed

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

Текущее количество используемых единиц. Это свойство наследуется от CIM_MediaAccessDevice.

UnloadTime

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

Время (в миллисекундах) от возможности чтения или записи носителя до его "выгрузки". Это свойство наследуется от CIM_MediaAccessDevice.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 [только классические приложения]
Пространство имен	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

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

CIM_DVDDrive
CIM_DVDDrive
Классы хранения

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