CIM_MediaAccessDevice 类（Hyper-V 管理）

项目
12/14/2023

表示可以使用媒体存储和检索数据的设备。

语法

[Abstract, Version("2.6.0"), UMLPackagePath("CIM::Device::StorageDevices"), AMENDMENT]
class CIM_MediaAccessDevice : CIM_LogicalDevice
{
  uint16   Capabilities[];
  string   CapabilityDescriptions[];
  string   ErrorMethodology;
  string   CompressionMethod;
  uint32   NumberOfMediaSupported;
  uint64   MaxMediaSize;
  uint64   DefaultBlockSize;
  uint64   MaxBlockSize;
  uint64   MinBlockSize;
  boolean  NeedsCleaning;
  boolean  MediaIsLocked;
  uint16   Security;
  datetime LastCleaned;
  uint64   MaxAccessTime;
  uint32   UncompressedDataRate;
  uint64   LoadTime;
  uint64   UnloadTime;
  uint64   MountCount;
  datetime TimeOfLastMount;
  uint64   TotalMountTime;
  string   UnitsDescription;
  uint64   MaxUnitsBeforeCleaning;
  uint64   UnitsUsed;
};

成员

CIM_MediaAccessDevice 类具有以下类型的成员：

方法
属性

方法

CIM_MediaAccessDevice 类具有以下方法。

方法	说明
LockMedia	锁定和解锁媒体访问设备中的可移动媒体。

属性

CIM_MediaAccessDevice 类具有以下属性。

功能

数据类型：uint16 数组
访问类型：只读
限定符：ArrayType ("Indexed")、MappingStrings（"MIF.DMTF|Storage Devices|001.9"、"MIF.DMTF|Storage Devices|001.11"、"MIF.DMTF|Storage Devices|001.12"、"MIF.DMTF|Disks|003.7"、"MIF.DMTF|Host Disk|001.2"、"MIF.DMTF|Host Disk|001.4"）、ModelCorrespondence ("CIM_MediaAccessDevice.CapabilityDescriptions")

一个数组，其中包含媒体访问设备的功能。

未知 (0)

其他 (1)

顺序存取 (2)

随机存取 (3)

支持写入 (4)

加密 (5)

压缩 (6)

支持可移动媒体 (7)

手动清洁 (8)

自动清洁 (9)

智能通知 (10)

支持双面媒体 (11)

不需要卸载前弹出 (12)

CapabilityDescriptions

数据类型：字符串数组
访问类型：只读
限定符：ArrayType ("Indexed")、ModelCorrespondence ("CIM_MediaAccessDevice.Capabilities")

一个数组，其中包含针对“Capabilities”数组中各项的功能说明。

CompressionMethod

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

设备用于支持压缩的算法或工具的名称。

如果未指定压缩类型，则可以使用以下值之一：

“Unknown”：压缩支持未知或未指定。
“Compressed”：支持压缩，但类型未知或未指定。
“Not Compressed”：设备不支持压缩功能。

DefaultBlockSize

数据类型：uint64
访问类型：只读
限定符：Units ("Bytes")、PUnit ("byte")

设备的默认块大小（以字节为单位）。

ErrorMethodology

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

设备支持的错误检测和更正类型。

LastCleaned

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

上次清理设备的日期和时间。

LoadTime

数据类型：uint64
访问类型：只读
限定符：Units ("MilliSeconds")、PUnit ("second * 10^-3")

设备在开始加载后能够读取或写入媒体所需的时间（以毫秒为单位）。例如，对于磁盘驱动器，这是从磁盘停止旋转到磁盘报告其已准备好进行读/写操作之间的间隔。对于磁带驱动器，这将在插入媒体时开始，在驱动器报告其已准备好用于应用程序时结束。这通常位于磁带的磁带开头 (BOT) 区域。

MaxAccessTime

数据类型：uint64
访问类型：只读
限定符：Units ("MilliSeconds")、PUnit ("second * 10^-3")

媒体的最大存取时间（以毫秒为单位）。对于磁盘驱动器，这表示完全寻道和完全旋转延迟。对于磁带驱动器，这表示从磁带的起点到物理距离最远的点的搜索。

MaxBlockSize

数据类型：uint64
访问类型：只读
限定符：Units ("Bytes")、PUnit ("byte")

设备访问的媒体的最大块大小（以字节为单位）。

MaxMediaSize

数据类型：uint64
访问类型：只读
限定符：MappingStrings（"MIF.DMTF|Sequential Access Devices|001.2"、"MIF.DMTF|Host Disk|001.5"）

设备支持的媒体的最大大小（以 KB 为单位）。

MaxUnitsBeforeCleaning

数据类型：uint64
访问类型：只读
限定符：ModelCorrespondence ("CIM_MediaAccessDevice.UnitsDescription")

在应该清理设备之前可以使用的最大单位数。 UnitsDescription 定义单位类型。

MediaIsLocked

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

如果媒体锁定在设备中且无法弹出，则为 true；否则为 false。对于不可移动设备，此值应为 true。

MinBlockSize

数据类型：uint64
访问类型：只读
限定符：Units ("Bytes")、PUnit ("byte")

设备访问的媒体的最小块大小（以字节为单位）。

MountCount

数据类型：uint64
访问类型：只读
限定符：Counter

已装载媒体来进行数据传输或清理设备的次数。如果设备不支持可移动媒体，则应将此属性设置为零。

NeedsCleaning

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

如果设备需要清洁，则为 true；否则为 false。

注意

“Capabilities”属性指示是否可以进行手动或自动清理。

NumberOfMediaSupported

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

如果设备支持多个单一媒体，则此属性定义可支持或插入的最大媒体数量。

安全性

数据类型：uint16
访问类型：只读
限定符：MappingStrings ("MIF.DMTF|Disks|003.22")

设备的运行安全性。

其他 (1)

未知 (2)

无 (3)

只读 (4)

已锁定 (5)

绕过启动 (6)

绕过启动，只读 (7)

TimeOfLastMount

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

在设备上装载媒体的最新日期和时间。此属性仅供支持可移动媒体的设备使用。

TotalMountTime

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

已装载媒体来进行数据传输或清理设备的时间（以秒为单位）。如果设备不支持可移动媒体，则应将此属性设置为零。

UncompressedDataRate

数据类型：uint32
访问类型：只读
限定符：Units ("KiloBytes per Second")、PUnit ("byte / second * 10^3")

设备可对一个媒体进行读取和写入的持续数据传输速率（以 KB 为单位）。这是持续的原始数据速率。请勿使用此属性报告最大速率或压缩速率。

UnitsDescription

数据类型：字符串
访问类型：只读
限定符：ModelCorrespondence（"CIM_MediaAccessDevice.MaxUnitsBeforeCleaning"、"CIM_MediaAccessDevice.UnitsUsed"）

描述 MaxUnitsBeforeCleaning 和 UnitsUsed 属性的单位类型。

UnitsUsed

数据类型：uint64
访问类型：只读
限定符：Gauge、ModelCorrespondence（"CIM_MediaAccessDevice.UnitsDescription"、"CIM_MediaAccessDevice.MaxUnitsBeforeCleaning"）

设备使用的单位数。此属性用于确定何时应清理设备。 UnitsDescription 定义单位类型。

UnloadTime

数据类型：uint64
访问类型：只读
限定符：Units ("MilliSeconds")、PUnit ("second * 10^-3")

设备从读取或写入媒体过渡到卸载所需的时间（以毫秒为单位）。例如，对于磁盘驱动器，这是磁盘以标称速度旋转到磁盘停止旋转之间的间隔。对于磁带驱动器，这是磁带从 BOT 区域弹出开始到完全弹出并可供拾取器元件或操作员取出的时间。

要求

要求	值
最低受支持的客户端	Windows 8
最低受支持的服务器	Windows Server 2012
命名空间	Root\virtualization\v2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

另请参阅

CIM_LogicalDevice

通过

CIM_MediaAccessDevice 类（Hyper-V 管理）

语法

成员

方法

属性

要求

另请参阅

反馈

其他资源