CIM_MediaAccessDevice class (Hyper-V management)
Represents a device that can use media to store and retrieve data.
Syntax
[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;
};
Members
The CIM_MediaAccessDevice class has these types of members:
Methods
The CIM_MediaAccessDevice class has these methods.
Method | Description |
---|---|
LockMedia | Locks and unlocks removable media in a media access device. |
Properties
The CIM_MediaAccessDevice class has these properties.
-
Capabilities
-
-
Data type: uint16 array
-
Access type: Read-only
-
Qualifiers: 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")
An array that contains the capabilities of the media access device.
-
-
Unknown (0)
-
Other (1)
-
Sequential Access (2)
-
Random Access (3)
-
Supports Writing (4)
-
Encryption (5)
-
Compression (6)
-
Supports Removeable Media (7)
-
Manual Cleaning (8)
-
Automatic Cleaning (9)
-
SMART Notification (10)
-
Supports Dual Sided Media (11)
-
Predismount Eject Not Required (12)
CapabilityDescriptions
-
Data type: string array
-
Access type: Read-only
-
Qualifiers: ArrayType ("Indexed"), ModelCorrespondence ("CIM_MediaAccessDevice.Capabilities")
An array of feature descriptions for the items in the Capabilities array.
CompressionMethod
-
Data type: string
-
Access type: Read-only
The name of the algorithm or tool used by the device to support compression.
If a compression type is not specified, one of the following values can be used:
- "Unknown" compression support is unknown or not specified.
- "Compressed" compression is supported but the type is unknown or unspecified.
- "Not Compressed" the device does not support compression capabilities.
DefaultBlockSize
-
Data type: uint64
-
Access type: Read-only
-
Qualifiers: Units ("Bytes"), PUnit ("byte")
The default block size, in bytes, for the device.
ErrorMethodology
-
Data type: string
-
Access type: Read-only
The type of error detection and correction supported by the device.
LastCleaned
-
Data type: datetime
-
Access type: Read-only
The date and time when the device was last cleaned.
LoadTime
-
Data type: uint64
-
Access type: Read-only
-
Qualifiers: Units ("MilliSeconds"), PUnit ("second * 10^-3")
The time it takes, in milliseconds, for the device to be able to read or write a media after the device starts loading. For example, for disk drives, this is the interval between a disk not spinning to the disk reporting that it is ready for read/write operations. For tape drives, this starts when media is inserted and ends when the drive reports that it is ready for an application. This is usually at the tape's beginning-of-tape (BOT) area.
MaxAccessTime
-
Data type: uint64
-
Access type: Read-only
-
Qualifiers: Units ("MilliSeconds"), PUnit ("second * 10^-3")
The maximum access time of the media, in milliseconds. For a disk drive, this represents full seek and full rotational delay. For tape drives, this represents a search from the beginning of the tape to the most physically distant point.
MaxBlockSize
-
Data type: uint64
-
Access type: Read-only
-
Qualifiers: Units ("Bytes"), PUnit ("byte")
The maximum block size, in bytes, for media accessed by the device.
MaxMediaSize
-
Data type: uint64
-
Access type: Read-only
-
Qualifiers: MappingStrings ("MIF.DMTF|Sequential Access Devices|001.2", "MIF.DMTF|Host Disk|001.5")
The maximum size, in kilobytes, of media supported by this device.
MaxUnitsBeforeCleaning
-
Data type: uint64
-
Access type: Read-only
-
Qualifiers: ModelCorrespondence ("CIM_MediaAccessDevice.UnitsDescription")
The maximum number of units that can be used before the device should be cleaned. UnitsDescription defines how the unit type.
MediaIsLocked
-
Data type: boolean
-
Access type: Read-only
true if the media is locked in the device and cannot be ejected; otherwise, false. For non-removable devices, this value should be true.
MinBlockSize
-
Data type: uint64
-
Access type: Read-only
-
Qualifiers: Units ("Bytes"), PUnit ("byte")
The minimum block size, in bytes, for media accessed by the device.
MountCount
-
Data type: uint64
-
Access type: Read-only
-
Qualifiers: Counter
The number of times that media has been mounted for data transfer or to clean the device. If the device does not support removable media, this property should be set to zero.
NeedsCleaning
-
Data type: boolean
-
Access type: Read-only
true if the device needs cleaning; otherwise, false.
Note
The Capabilities property indicates whether manual or automatic cleaning is possible.
NumberOfMediaSupported
-
Data type: uint32
-
Access type: Read-only
If the device supports multiple individual media, this property defines the maximum number which can be supported or inserted.
Security
-
Data type: uint16
-
Access type: Read-only
-
Qualifiers: MappingStrings ("MIF.DMTF|Disks|003.22")
The operational security for the device.
Other (1)
Unknown (2)
None (3)
Read Only (4)
Locked Out (5)
Boot Bypass (6)
Boot Bypass and Read Only (7)
TimeOfLastMount
-
Data type: datetime
-
Access type: Read-only
The most recent date and time when media was mounted on the device. This property is only used by devices that support removable media.
TotalMountTime
-
Data type: uint64
-
Access type: Read-only
The time, in seconds, that media has been mounted for data transfer or to clean the device. If the device does not support removable media, this property should be set to zero.
UncompressedDataRate
-
Data type: uint32
-
Access type: Read-only
-
Qualifiers: Units ("KiloBytes per Second"), PUnit ("byte / second * 10^3")
The sustained data transfer rate in kilobytes at which the device can read and write to a media. This is a sustained, raw data rate. Maximum rates or rates with compression should not be reported in this property.
UnitsDescription
-
Data type: string
-
Access type: Read-only
-
Qualifiers: ModelCorrespondence ("CIM_MediaAccessDevice.MaxUnitsBeforeCleaning", "CIM_MediaAccessDevice.UnitsUsed")
Describes the unit type of the MaxUnitsBeforeCleaning and UnitsUsed properties.
UnitsUsed
-
Data type: uint64
-
Access type: Read-only
-
Qualifiers: Gauge, ModelCorrespondence ("CIM_MediaAccessDevice.UnitsDescription", "CIM_MediaAccessDevice.MaxUnitsBeforeCleaning")
The number of units used by the device. This property is used to determine when the device should be cleaned. UnitsDescription defines how the unit type.
UnloadTime
-
Data type: uint64
-
Access type: Read-only
-
Qualifiers: Units ("MilliSeconds"), PUnit ("second * 10^-3")
The time it takes, in milliseconds, for the device to transition from reading or writing media to unloading. For example, for disk drives, this is the interval between a disk spinning at nominal speeds and a disk not spinning. For tape drives, this is the time for a media to go from its BOT to being fully ejected and accessible to a picker element or human operator.
Requirements
Requirement | Value |
---|---|
Minimum supported client |
Windows 8 |
Minimum supported server |
Windows Server 2012 |
Namespace |
Root\virtualization\v2 |
MOF |
|
DLL |
|