Msvm_DVDDrive クラス

[アーティクル]
06/12/2023

仮想マシン内の DVD ドライブを表します。この DVD ドライブは、パススルーデバイス (物理ハードディスクが仮想マシンに接続されている場合) または合成デバイスで、ISO ファイルメディアが設定されます。仮想および物理 DVD ドライブは仮想マシンに追加および削除できるため、このクラスに関連付けられている 2 つのリソースプールがあります。1 つはパススルー DVD ドライブ用、もう 1 つは仮想 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から継承されます。

Capabilities

データ型: 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
アクセスの種類: 読み取り専用

論理ファイルの圧縮に使用されるアルゴリズムまたはツールを示す文字列。圧縮スキームが不明であるか、説明されていない場合は、"不明" を使用します。論理ファイルが圧縮されていても、圧縮スキームが不明であるか、説明されていない場合は、"圧縮" を使用します。論理ファイルが圧縮されていない場合は、"圧縮されていない" を使用します。このプロパティは、 CIM_MediaAccessDeviceから継承されます。

"圧縮されていません"

"Unknown"

"圧縮"

"圧縮されていません"

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から継承されます。

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
アクセスの種類: 読み取り専用

このデバイスでサポートされているメディアの最大サイズ (キロバイト単位)。キロバイトは、バイト数に 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から継承されます。

Name

データ型: 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
アクセスの種類: 読み取り専用

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から継承されます。

Security

データ型: uint16
アクセスの種類: 読み取り専用

デバイスに対して定義された運用セキュリティ。このプロパティは、 CIM_MediaAccessDeviceから継承されます。

状態

データ型: string
アクセスの種類: 読み取り専用

オブジェクトの現在の状態。このプロパティは CIM_ManagedSystemElementから継承されますが、使用されません。

StatusDescriptions

データ型: 文字列 配列
アクセスの種類: 読み取り専用

さまざまな 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から継承されますが、使用されません。

CompressedDataRate

データ型: uint32
アクセスの種類: 読み取り専用

デバイスがメディアから読み取りおよび書き込みを行うことができる持続的なデータ転送速度 (KB/秒)。これは、持続的な生データレートです。圧縮を想定した最大レートまたはレートは、このプロパティで報告しないでください。このプロパティは、 CIM_MediaAccessDeviceから継承されます。

UnitsDescription

データ型: string
アクセスの種類: 読み取り専用

MaxUnitsBeforeCleaning での使用に対する相対的な単位。このプロパティは、 CIM_MediaAccessDeviceから継承されます。

UnitsUsed

データ型: uint64
アクセスの種類: 読み取り専用

現在使用されている単位数。このプロパティは、 CIM_MediaAccessDeviceから継承されます。

UnloadTime

データ型: uint64
アクセスの種類: 読み取り専用

メディアの読み取りまたは書き込みが可能から "アンロード" までの時間 (ミリ秒単位)。このプロパティは、 CIM_MediaAccessDeviceから継承されます。

注釈

MSVM_DVDDRIVE クラスへのアクセスは、UAC フィルター処理によって制限される場合があります。詳細については、「ユーザーアカウント制御と WMI」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップアプリのみ]
名前空間	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
[DLL]	Vmms.exe

こちらもご覧ください

CIM_DVDDrive
CIM_DVDDrive
ストレージクラス

次の方法で共有

Msvm_DVDDrive クラス

構文

メンバー

メソッド

プロパティ

注釈

要件

こちらもご覧ください

フィードバック

その他のリソース