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	请求状态更改。
重置	重置虚拟设备。
RestoreProperties	不支持此方法。
SaveProperties	不支持此方法。
SetPowerState	不支持此方法。

属性

Msvm_DVDDrive 类具有这些属性。

AdditionalAvailability

数据类型： uint16 数组
访问类型：只读

设备的任何其他可用性和状态。此属性继承自 CIM_LogicalDevice，) 设置为 6 (不适用。

可用性

数据类型： uint16
访问类型：只读

设备的主要可用性和状态。此属性继承自 CIM_LogicalDevice，) 设置为 6 (不适用。

AvailableRequestedStates

数据类型： uint16 数组
访问类型：只读

指示用于启动状态更改的 RequestStateChange 方法的 RequestedState 参数的可能值。列出的值将是CIM_EnabledLogicalElementCapabilities关联实例的 RequestedStatesSupported 属性中包含的值的子集，其中所选值是CIM_EnabledLogicalElement对象的当前状态的函数。如果实现能够将一组可能的值播发为当前状态的函数，则此属性可以是非 Null 。如果实现无法确定作为当前状态函数的可能值集，则此属性将为 Null 。

此属性继承自 CIM_EnabledLogicalElement。

功能

数据类型： uint32 数组
访问类型：只读

媒体访问设备的功能。此属性继承自 CIM_MediaAccessDevice，并设置为以下值。

值	含义
{3, 7}
3	CapabilityDescriptions 中的相应条目为“随机访问”。
7	CapabilityDescriptions 中的相应条目为“支持可移动媒体”。

CapabilityDescriptions

数据类型： 字符串 数组
访问类型：只读

一个自由格式字符串数组，提供有关 Capabilities 属性数组中指示的访问设备功能的详细说明。此数组的每个条目都与位于同一索引的 Capabilities 属性数组中的条目相关。此属性继承自 CIM_MediaAccessDevice。

Caption

数据类型： string
访问类型：只读

对象的简短说明。此属性继承自 CIM_ManagedElement。

CommunicationStatus

数据类型： uint16
访问类型：只读

指示检测与基础托管元素通信的能力。 Null 值指示未实现此属性。此属性继承自 CIM_ManagedSystemElement。

CompressionMethod

数据类型： string
访问类型：只读

一个字符串，指示用于压缩逻辑文件的算法或工具。如果压缩方案未知或未描述，请使用“未知”。如果逻辑文件已压缩，但压缩方案未知或未描述，请使用“Compressed”。如果逻辑文件未压缩，请使用“未压缩”。此属性继承自 CIM_MediaAccessDevice。

“未压缩”

"Unknown"

“Compressed”

“未压缩”

CreationClassName

数据类型： uint16
访问类型：只读

创建实例时使用的类或子类的名称。此属性继承自 CIM_LogicalDevice。

DefaultBlockSize

数据类型： uint64
访问类型：只读

设备的默认块大小（以字节为单位）。此属性继承自 CIM_MediaAccessDevice。

描述

数据类型： 字符串
访问类型：只读

对象的说明。此属性继承自 CIM_ManagedElement。

DetailedStatus

数据类型： uint16
访问类型：只读

使用其他状态详细信息补充 PrimaryStatus 属性。 Null 值表示未实现此属性。此属性继承自 CIM_ManagedSystemElement。

DeviceID

数据类型： 字符串
访问类型：只读

此属性继承自 CIM_LogicalDevice，并设置为“Microsoft：GUID\device-specific-data”。

ElementName

数据类型： 字符串
访问类型：只读

对象的显示名称。此属性继承自 CIM_ManagedElement。

EnabledDefault

数据类型： uint16
访问类型：只读

元素的已启用状态的管理员默认或启动配置。此属性继承自 CIM_EnabledLogicalElement。

EnabledState

数据类型： uint16
访问类型：只读

元素的启用和禁用状态。它还可以指示这些请求状态之间的转换。此属性继承自 CIM_EnabledLogicalElement。

ErrorCleared

数据类型： 布尔值
访问类型：只读

指示现在是否清除 LastErrorCode 中报告的错误。此属性继承自 CIM_LogicalDevice，但不使用它。

ErrorDescription

数据类型： 字符串
访问类型：只读

一个字符串，提供有关 LastErrorCode 中记录的错误的详细信息，以及有关可以采取的任何纠正措施的信息。此属性继承自 CIM_LogicalDevice，但不使用它。

ErrorMethodology

数据类型： 字符串
访问类型：只读

描述此设备支持的错误检测和更正类型的字符串。此属性继承自 CIM_MediaAccessDevice。

FormatsSupported

数据类型： uint16 数组
访问类型：只读

此设备支持的 CD 和 DVD 格式。此属性继承自 CIM_DVDDrive。

此数组包含以下 ISO 值。

{16, 22}
CD-ROM (16)
DVD (22)

此数组包含以下物理直通值。

未知 (0)
其他 (1)
CD-ROM (16)
CD-ROM/XA (17)
CD-I (18)
CD 可录制 (19)
DVD (22)
DVD-RW+ (23)
DVD-RAM (24)
DVD-ROM (25)
DVD-Video (26)
Divx (27)
CD-RW (33)
CD-DA (34)
CD+ (35)
DVD 可录制 (36)
DVD-RW (37)
DVD-Audio (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
访问类型：只读

从“加载”到能够读取或写入媒体的时间（以毫秒为单位）。例如，对于磁盘驱动器，这是磁盘不旋转到报告它已准备好进行读/写 (即磁盘以名义速度旋转) 之间的间隔。对于磁带驱动器，这是从注入介质到报告它已准备好用于应用程序的时间。这通常位于磁带的 BOT 区域。此属性继承自 CIM_MediaAccessDevice。

MaxAccessTime

数据类型： uint64
访问类型：只读

从媒体上的第一个位置移动到相对于时间最远的位置的时间，以毫秒为单位。对于磁盘驱动器，这表示完全寻道 + 完全旋转延迟。对于磁带驱动器，这表示从磁带开头到物理距离最远的点的搜索。 (磁带的末端可能位于其物理上最远的点，但不一定如此。) 此属性继承自 CIM_MediaAccessDevice。

MaxBlockSize

数据类型： uint64
访问类型：只读

设备访问的媒体的最大块大小（以字节为单位）。此属性继承自 CIM_MediaAccessDevice。

MaxMediaSize

数据类型： uint64
访问类型：只读

此设备支持的媒体的最大大小（以 KB 为单位）。千字节解释为字节数乘以 1000 (而不是字节数乘以 1024) 。此属性继承自 CIM_MediaAccessDevice。

MaxQuiesceTime

数据类型： uint64
访问类型：只读

此属性已弃用。此属性继承自 CIM_LogicalDevice，但不使用它。

MaxUnitsBeforeCleaning

数据类型： uint64
访问类型：只读

在清理设备之前可以使用的最大单位数。此属性继承自 CIM_MediaAccessDevice。

MediaIsLocked

数据类型： 布尔值
访问类型：只读

如果媒体在设备中锁定且无法弹出，则其值为 True;否则为 False。此属性继承自 CIM_MediaAccessDevice。

MinBlockSize

数据类型： uint64
访问类型：只读

设备访问的媒体的最小块大小（以字节为单位）。此属性继承自 CIM_MediaAccessDevice。

MountCount

数据类型： uint64
访问类型：只读

对于支持可移动媒体的设备，为数据传输或清理设备装载媒体的次数。对于访问不可移动媒体（如硬盘）的设备，此属性不适用，应设置为 0。此属性继承自 CIM_MediaAccessDevice。

名称

数据类型： string
访问类型：只读

对象的已知标签。此属性继承自 CIM_ManagedSystemElement，与 ElementName 属性相同。

NeedsCleaning

数据类型： 布尔值
访问类型：只读

如此如果 媒体访问设备需要清洁;否则为 False。此属性继承自 CIM_MediaAccessDevice。

NumberOfMediaSupported

数据类型： uint32
访问类型：只读

可支持或插入的多个单个介质的最大数目。此属性继承自 CIM_MediaAccessDevice。

OperatingStatus

数据类型： uint16
访问类型：只读

提供元素操作条件的当前状态信息，并可用于提供有关 EnabledState 属性值的更多详细信息。 Null 值指示未实现此属性。此属性继承自 CIM_ManagedSystemElement。

OperationalStatus

数据类型： uint16 数组
访问类型：只读

对象的当前状态。此属性继承自 CIM_ManagedSystemElement。

OtherEnabledState

数据类型： string
访问类型：只读

EnabledState 属性设置为 1 时元素的启用或禁用状态， (Other) 。当 EnabledState 属性是除 1 以外的任何值时，此属性必须设置为 Null。此属性继承自 CIM_EnabledLogicalElement。

OtherIdentifyingInfo

数据类型： 字符串 数组
访问类型：只读

除设备 ID 信息外，可用于标识逻辑设备的任何其他数据。此属性继承自 CIM_LogicalDevice，并设置为 Null。

PowerManagementCapabilities

数据类型： uint16 数组
访问类型：只读

设备的电源管理功能。此属性继承自 CIM_LogicalDevice，但不使用它。

PowerManagementSupported

数据类型： 布尔值
访问类型：只读

指示设备是否可以进行电源管理。此属性继承自 CIM_LogicalDevice，但不使用它。

PowerOnHours

数据类型： uint64
访问类型：只读

此设备自上次电源周期以来已开机的连续小时数。此属性继承自 CIM_LogicalDevice，但不使用它。

PrimaryStatus

数据类型： uint16
访问类型：只读

提供高级状态信息。此属性应与 DetailedStatus 属性结合使用，以便为元素及其子组件提供高级别和详细的运行状况状态信息。 Null 值表示未实现此属性。此属性继承自 CIM_ManagedSystemElement。

RequestedState

数据类型： uint16
访问类型：只读

元素的最后一个请求或所需状态。元素的实际状态由 EnabledState 属性表示。提供此属性用于比较上次请求的状态和当前启用或禁用的状态。 CIM_EnabledLogicalElement 的特定实例可能不支持 RequestStateChange 方法。如果发生这种情况，则使用值 12 (不适用) 。此属性继承自 CIM_EnabledLogicalElement。

安全性

数据类型： uint16
访问类型：只读

为设备定义的操作安全性。此属性继承自 CIM_MediaAccessDevice。

Status

数据类型： 字符串
访问类型：只读

对象的当前状态。此属性继承自 CIM_ManagedSystemElement，但不使用它。

StatusDescriptions

数据类型： 字符串 数组
访问类型：只读

描述各种 OperationalStatus 数组值的字符串。此属性继承自 CIM_ManagedSystemElement。

StatusInfo

数据类型： uint16
访问类型：只读

逻辑设备的当前状态。此属性继承自 CIM_LogicalDevice，但不使用它。

SystemCreationClassName

数据类型： 字符串
访问类型：只读

范围系统的创建类名称。此属性继承自 CIM_LogicalDevice。

SystemName

数据类型： 字符串
访问类型：只读

范围虚拟机的唯一标识符。此属性继承自 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
访问类型：只读

设备可以读取和写入媒体的持续数据传输速率（以 KB/秒为单位）。这是一个持续的原始数据速率。不应在此属性中报告假定压缩的最大速率或速率。此属性继承自 CIM_MediaAccessDevice。

UnitsDescription

数据类型： 字符串
访问类型：只读

与其在 MaxUnitsBeforeCleaning 中的用法相关的单位。此属性继承自 CIM_MediaAccessDevice。

UnitsUsed

数据类型： uint64
访问类型：只读

当前使用的单位数。此属性继承自 CIM_MediaAccessDevice。

UnloadTime

数据类型： uint64
访问类型：只读

从能够读取或写入媒体到其“卸载”的时间（以毫秒为单位）。此属性继承自 CIM_MediaAccessDevice。

备注

UAC 筛选可能会限制对 Msvm_DVDDrive 类的访问。有关详细信息，请参阅用户帐户控制和 WMI。

要求

要求	值
最低受支持的客户端	Windows 8 [仅限桌面应用]
最低受支持的服务器	Windows Server 2012 [仅限桌面应用]
命名空间	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

另请参阅

CIM_DVDDrive
CIM_DVDDrive
存储类

通过

Msvm_DVDDrive 类

语法

成员

方法

属性

备注

要求

另请参阅

反馈

其他资源