MSVM _ DVDDrive, classe

Représente un lecteur de DVD à l’intérieur d’une machine virtuelle. Ce lecteur de DVD peut être un périphérique direct (si un disque dur physique a été attaché à la machine virtuelle) ou synthétique et rempli avec un support de fichier ISO. Étant donné que les lecteurs de DVD virtuels et physiques peuvent être ajoutés et supprimés de la machine virtuelle, il existe deux pools de ressources associés à cette classe, l’un pour les lecteurs de DVD direct et l’autre pour les lecteurs de DVD virtuels. Les lecteurs de DVD ne peuvent être ajoutés ou supprimés que si la machine virtuelle est hors connexion.

La syntaxe suivante est simplifiée format MOF (MOF) et comprend toutes les propriétés héritées.

Syntaxe

[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};
};

Membres

La classe MSVM _ DVDDrive possède les types de membres suivants :

Méthodes

La classe MSVM _ DVDDrive possède ces méthodes.

Méthode Description
EnableDevice Cette méthode n'est pas prise en charge.
LockMedia Verrouille ou libère le média.
OnlineDevice Cette méthode n'est pas prise en charge.
QuiesceDevice Cette méthode n'est pas prise en charge.
RequestStateChange Demande un changement d’État.
Réinitialiser Réinitialise l’appareil virtuel.
RestoreProperties Cette méthode n'est pas prise en charge.
SaveProperties Cette méthode n'est pas prise en charge.
SetPowerState Cette méthode n'est pas prise en charge.

Propriétés

La classe MSVM _ DVDDrive possède les propriétés suivantes.

AdditionalAvailability

Type de données : tableau UInt16

Type d'accès : Lecture seule

Disponibilité et état supplémentaires de l’appareil. Cette propriété est héritée de CIM _ LogicalDeviceet est définie sur 6 (non applicable).

Disponibilité

Type de données : UInt16

Type d'accès : Lecture seule

Disponibilité et état principaux de l’appareil. Cette propriété est héritée de CIM _ LogicalDeviceet est définie sur 6 (non applicable).

AvailableRequestedStates

Type de données : tableau UInt16

Type d'accès : Lecture seule

Indique les valeurs possibles pour le paramètre RequestedState de la méthode RequestStateChange utilisée pour initier un changement d’État. Les valeurs répertoriées sont un sous-ensemble des valeurs contenues dans la propriété RequestedStatesSupported de l’instance associée de la _ EnabledLogicalElementCapabilities CIM, où les valeurs sélectionnées sont une fonction de l’état actuel de l’objet _ EnabledLogicalElement CIM . Cette propriété peut être non null si une implémentation est en mesure de publier l’ensemble de valeurs possibles en tant que fonction de l’état actuel. Cette propriété a la valeur null si une implémentation ne peut pas déterminer le jeu de valeurs possibles en tant que fonction de l’état actuel.

Cette propriété est héritée de la _ EnabledLogicalElement CIM.

Capabilities

Type de données : tableau UInt32

Type d'accès : Lecture seule

Fonctionnalités de l’appareil d’accès aux médias. Cette propriété est héritée de la _ MediaAccessDevice CIMet est définie avec les valeurs suivantes.

Valeur Signification
{3, 7}
3
L’entrée correspondante dans CapabilityDescriptions est « accès aléatoire ».
7
L’entrée correspondante dans CapabilityDescriptions est « prend en charge les supports amovibles ».

CapabilityDescriptions

Type de données : tableau de chaînes

Type d'accès : Lecture seule

Tableau de chaînes de forme libre qui fournit des explications détaillées sur l’accès aux fonctionnalités d’appareil indiquées dans le tableau de propriétés Capabilities . Chaque entrée de ce tableau est liée à l’entrée dans le tableau de propriétés des fonctionnalités , situé dans le même index. Cette propriété est héritée de la _ MediaAccessDevice CIM.

Caption

Type de données : chaîne

Type d'accès : Lecture seule

Brève description de l’objet. Cette propriété est héritée de la _ propriété ManagedElement CIM.

CommunicationStatus

Type de données : UInt16

Type d'accès : Lecture seule

Indique la capacité de l’instrumentation à communiquer avec l’élément managé sous-jacent. Une valeur null indique que cette propriété n’est pas implémentée. Cette propriété est héritée de CIM _ ManagedSystemElement.

CompressionMethod

Type de données : chaîne

Type d'accès : Lecture seule

Chaîne qui indique l’algorithme ou l’outil utilisé pour compresser le fichier logique. Si le schéma de compression est inconnu ou n’est pas décrit, utilisez « inconnu ». Si le fichier logique est compressé, mais que le schéma de compression est inconnu ou non décrit, utilisez « compressé ». Si le fichier logique n’est pas compressé, utilisez « non compressé ». Cette propriété est héritée de la _ MediaAccessDevice CIM.

« Non compressé »

Connue

Compact

« Non compressé »

CreationClassName

Type de données : UInt16

Type d'accès : Lecture seule

Nom de la classe ou de la sous-classe utilisée dans la création d’une instance. Cette propriété est héritée de CIM _ LogicalDevice.

DefaultBlockSize

Type de données : UInt64

Type d'accès : Lecture seule

Taille de bloc par défaut, en octets, pour l’appareil. Cette propriété est héritée de la _ MediaAccessDevice CIM.

Description

Type de données : chaîne

Type d'accès : Lecture seule

Description de l'objet . Cette propriété est héritée de la _ propriété ManagedElement CIM.

DetailedStatus

Type de données : UInt16

Type d'accès : Lecture seule

Complète la propriété PrimaryStatus avec des détails d’État supplémentaires. Une valeur null indique que cette propriété n’est pas implémentée. Cette propriété est héritée de CIM _ ManagedSystemElement.

DeviceID

Type de données : chaîne

Type d'accès : Lecture seule

Cette propriété est héritée de CIM _ LogicalDeviceet est définie sur « Microsoft :GUID \ Device-Specific-Data».

ElementName

Type de données : chaîne

Type d'accès : Lecture seule

Nom complet de l’objet. Cette propriété est héritée de la _ propriété ManagedElement CIM.

EnabledDefault

Type de données : UInt16

Type d'accès : Lecture seule

Configuration par défaut ou de démarrage d’un administrateur pour l’état activé d’un élément. Cette propriété est héritée de la _ EnabledLogicalElement CIM.

EnabledState

Type de données : UInt16

Type d'accès : Lecture seule

États activés et désactivés d’un élément. Il peut également indiquer les transitions entre ces États demandés. Cette propriété est héritée de la _ EnabledLogicalElement CIM.

ErrorCleared

Type de données : booléen

Type d'accès : Lecture seule

Indique si l’erreur signalée dans LastErrorCode est maintenant désactivée. Cette propriété est héritée de CIM _ LogicalDevice, mais elle n’est pas utilisée.

ErrorDescription

Type de données : chaîne

Type d'accès : Lecture seule

Chaîne qui fournit des informations supplémentaires sur l’erreur enregistrée dans LastErrorCode et des informations sur les actions correctives qui peuvent être effectuées. Cette propriété est héritée de CIM _ LogicalDevice, mais elle n’est pas utilisée.

ErrorMethodology

Type de données : chaîne

Type d'accès : Lecture seule

Chaîne qui décrit les types de détection d’erreurs et de correction pris en charge par cet appareil. Cette propriété est héritée de la _ MediaAccessDevice CIM.

FormatsSupported

Type de données : tableau UInt16

Type d'accès : Lecture seule

Formats CD et DVD pris en charge par cet appareil. Cette propriété est héritée de la _ DVDDrive CIM.

Ce tableau contient les valeurs suivantes pour ISO.

{16, 22}

CD-ROM (16)

DVD (22)

Ce tableau contient les valeurs suivantes pour le transfert physique.

Inconnu (0)

Autre (1)

CD-ROM (16)

CD-ROM/XA (17)

CD-I (18)

CD inscriptible (19)

DVD (22)

DVD-RW + (23)

DVD-RAM (24)

DVD-ROM (25)

DVD-vidéo (26)

DivX (27)

CD-RW (33)

CD-DA (34)

CD + (35)

DVD enregistrable (36)

DVD-RW (37)

DVD-audio (38)

DVD-5 (39)

DVD-9 (40)

DVD-10 (41)

DVD-18 (42)

HealthState

Type de données : UInt16

Type d'accès : Lecture seule

Intégrité actuelle de l’élément. Cet attribut exprime l’intégrité de cet élément, mais pas nécessairement celle de ses sous-composants. Les valeurs possibles sont comprises entre 0 et 30, où 5 signifie que l’élément est entièrement sain et 30 signifie que l’élément est complètement non opérationnel. Cette propriété est héritée de CIM _ ManagedSystemElement.

IdentifyingDescriptions

Type de données : tableau de chaînes

Type d'accès : Lecture seule

Tableau de chaînes de forme libre qui fournissent des explications et des détails sur les entrées du tableau de propriétés OtherIdentifyingInfo . Cette propriété est héritée de CIM _ LogicalDeviceet est définie sur null.

InstallDate

Type de données : DateTime

Type d'accès : Lecture seule

Date et heure de création de la configuration de l’ordinateur virtuel. Cette propriété est héritée de CIM _ ManagedSystemElement.

InstanceID

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : clé

Identifie de façon unique une instance de cette classe. Cette propriété est héritée de la _ propriété ManagedElement CIM.

LastCleaned

Type de données : DateTime

Type d'accès : Lecture seule

Date et heure du dernier nettoyage de l’appareil. Cette propriété est héritée de la _ MediaAccessDevice CIM.

LastErrorCode

Type de données : UInt32

Type d'accès : Lecture seule

Dernier code d’erreur signalé par l’unité logique. Cette propriété est héritée de CIM _ LogicalDevice, mais elle n’est pas utilisée.

LoadTime

Type de données : UInt64

Type d'accès : Lecture seule

Durée, en millisecondes, à partir de « Load » pour pouvoir lire ou écrire un média. Par exemple, pour les lecteurs de disque, il s’agit de l’intervalle entre un disque qui ne tourne pas vers le disque signalant qu’il est prêt pour la lecture/écriture (c’est-à-dire le disque tournant à des vitesses nominales). Pour les lecteurs de bande, il s’agit de l’heure à partir d’un support injecté pour signaler qu’il est prêt pour une application. Il s’agit généralement de la zone de robot de la bande. Cette propriété est héritée de la _ MediaAccessDevice CIM.

MaxAccessTime

Type de données : UInt64

Type d'accès : Lecture seule

Durée, en millisecondes, à passer du premier emplacement sur le média à l’emplacement le plus éloigné par rapport au temps. Pour un lecteur de disque, il s’agit de la recherche complète et du délai de rotation complète. Pour les lecteurs de bande, il s’agit d’une recherche à partir du début de la bande jusqu’au point le plus éloigné physiquement. (La fin d’une bande peut être à son point le plus éloigné physiquement, mais cela n’est pas nécessairement vrai.) Cette propriété est héritée de la _ MediaAccessDevice CIM.

MaxBlockSize

Type de données : UInt64

Type d'accès : Lecture seule

Taille maximale de bloc, en octets, pour les médias accessibles par l’appareil. Cette propriété est héritée de la _ MediaAccessDevice CIM.

MaxMediaSize

Type de données : UInt64

Type d'accès : Lecture seule

Taille maximale, en kilo-octets, des médias pris en charge par cet appareil. Les kilo-octets sont interprétés comme le nombre d’octets multiplié par 1000 (pas le nombre d’octets multiplié par 1024). Cette propriété est héritée de la _ MediaAccessDevice CIM.

MaxQuiesceTime

Type de données : UInt64

Type d'accès : Lecture seule

Cette propriété est dépréciée. Cette propriété est héritée de CIM _ LogicalDevice, mais elle n’est pas utilisée.

MaxUnitsBeforeCleaning

Type de données : UInt64

Type d'accès : Lecture seule

Unités maximales qui peuvent être utilisées avant le nettoyage de l’appareil. Cette propriété est héritée de la _ MediaAccessDevice CIM.

MediaIsLocked

Type de données : booléen

Type d'accès : Lecture seule

True si le média est verrouillé dans l’appareil et ne peut pas être éjecté ; Sinon, false. Cette propriété est héritée de la _ MediaAccessDevice CIM.

MinBlockSize

Type de données : UInt64

Type d'accès : Lecture seule

Taille de bloc minimale, en octets, pour les médias accessibles par l’appareil. Cette propriété est héritée de la _ MediaAccessDevice CIM.

MountCount

Type de données : UInt64

Type d'accès : Lecture seule

Pour un appareil qui prend en charge les supports amovibles, le nombre de fois que ces médias ont été montés pour le transfert de données ou pour nettoyer l’appareil. Pour les appareils qui accèdent à des médias non amovibles, tels que des disques durs, cette propriété n’est pas applicable et doit être définie sur 0. Cette propriété est héritée de la _ MediaAccessDevice CIM.

Nom

Type de données : chaîne

Type d'accès : Lecture seule

Étiquette par laquelle l’objet est connu. Cette propriété est héritée de CIM _ ManagedSystemElementet est identique à la propriété ElementName .

NeedsCleaning

Type de données : booléen

Type d'accès : Lecture seule

True si l’appareil d’accès aux médias doit être nettoyé ; Sinon, false. Cette propriété est héritée de la _ MediaAccessDevice CIM.

NumberOfMediaSupported

Type de données : UInt32

Type d'accès : Lecture seule

Nombre maximal de plusieurs médias individuels qui peuvent être pris en charge ou insérés. Cette propriété est héritée de la _ MediaAccessDevice CIM.

OperatingStatus

Type de données : UInt16

Type d'accès : Lecture seule

Fournit des informations sur l’état actuel de la condition opérationnelle de l’élément et peut être utilisé pour fournir plus de détails concernant la valeur de la propriété EnabledState . Une valeur null indique que cette propriété n’est pas implémentée. Cette propriété est héritée de CIM _ ManagedSystemElement.

OperationalStatus

Type de données : tableau UInt16

Type d'accès : Lecture seule

États actuels de l’objet. Cette propriété est héritée de CIM _ ManagedSystemElement.

OtherEnabledState

Type de données : chaîne

Type d'accès : Lecture seule

État activé ou désactivé de l’élément lorsque la propriété EnabledState a la valeur 1 (autre). Cette propriété doit être définie sur null lorsque la propriété EnabledState a une valeur autre que 1. Cette propriété est héritée de la _ EnabledLogicalElement CIM.

OtherIdentifyingInfo

Type de données : tableau de chaînes

Type d'accès : Lecture seule

Toutes les données supplémentaires, au-delà des informations d’ID d’appareil, qui peuvent être utilisées pour identifier un périphérique logique. Cette propriété est héritée de CIM _ LogicalDeviceet est définie sur null.

PowerManagementCapabilities

Type de données : tableau UInt16

Type d'accès : Lecture seule

Les fonctionnalités de gestion de l’alimentation de l’appareil. Cette propriété est héritée de CIM _ LogicalDevice, mais elle n’est pas utilisée.

PowerManagementSupported

Type de données : booléen

Type d'accès : Lecture seule

Indique si l’appareil peut être géré par l’alimentation. Cette propriété est héritée de CIM _ LogicalDevice, mais elle n’est pas utilisée.

PowerOnHours

Type de données : UInt64

Type d'accès : Lecture seule

Nombre d’heures consécutives de mise sous tension de cet appareil depuis son dernier cycle d’alimentation. Cette propriété est héritée de CIM _ LogicalDevice, mais elle n’est pas utilisée.

PrimaryStatus

Type de données : UInt16

Type d'accès : Lecture seule

Fournit des informations d’état de haut niveau. Cette propriété doit être utilisée conjointement avec la propriété DetailedStatus pour fournir des informations d’état d’intégrité de haut niveau et détaillées pour l’élément et ses sous-composants. Une valeur null indique que cette propriété n’est pas implémentée. Cette propriété est héritée de CIM _ ManagedSystemElement.

RequestedState

Type de données : UInt16

Type d'accès : Lecture seule

Dernier État demandé ou souhaité pour l’élément. L’état réel de l’élément est représenté par la propriété EnabledState . Cette propriété est fournie pour comparer les derniers États activés et actuellement activés ou désactivés. Une instance particulière de _ EnabledLogicalElement CIM peut ne pas prendre en charge la méthode RequestStateChange . Si cela se produit, la valeur 12 (non applicable) est utilisée. Cette propriété est héritée de la _ EnabledLogicalElement CIM.

Sécurité

Type de données : UInt16

Type d'accès : Lecture seule

La sécurité opérationnelle définie pour l’appareil. Cette propriété est héritée de la _ MediaAccessDevice CIM.

État

Type de données : chaîne

Type d'accès : Lecture seule

État actuel de l’objet. Cette propriété est héritée de CIM _ ManagedSystemElement, mais elle n’est pas utilisée.

StatusDescriptions

Type de données : tableau de chaînes

Type d'accès : Lecture seule

Chaînes qui décrivent les différentes valeurs de tableau OperationalStatus . Cette propriété est héritée de CIM _ ManagedSystemElement.

StatusInfo

Type de données : UInt16

Type d'accès : Lecture seule

État actuel de l’unité logique. Cette propriété est héritée de CIM _ LogicalDevice, mais elle n’est pas utilisée.

SystemCreationClassName

Type de données : chaîne

Type d'accès : Lecture seule

Nom de la classe de création du système d’étendue. Cette propriété est héritée de CIM _ LogicalDevice.

SystemName

Type de données : chaîne

Type d'accès : Lecture seule

Identificateur unique de la machine virtuelle d’étendue. Cette propriété est héritée de CIM _ LogicalDevice.

TimeOfLastMount

Type de données : DateTime

Type d'accès : Lecture seule

Pour un appareil qui prend en charge les supports amovibles, la date et l’heure les plus récentes de montage du média sur l’appareil. Pour les appareils qui accèdent à des médias non amovibles, tels que des disques durs, cette propriété n’a aucune signification et n’est pas applicable. Cette propriété est héritée de la _ MediaAccessDevice CIM.

TimeOfLastStateChange

Type de données : DateTime

Type d'accès : Lecture seule

Date ou heure de la dernière modification de l’état activé de l’élément. Cette propriété est héritée de CIM _ EnabledLogicalElementet est toujours définie sur null.

TotalMountTime

Type de données : UInt64

Type d'accès : Lecture seule

Pour un appareil qui prend en charge les supports amovibles, durée totale (en secondes) de montage des médias pour le transfert de données ou le nettoyage de l’appareil. Pour les appareils qui accèdent à des médias non amovibles, tels que des disques durs, cette propriété n’est pas applicable et doit être définie sur 0. Cette propriété est héritée de la _ MediaAccessDevice CIM.

TotalPowerOnHours

Type de données : UInt64

Type d'accès : Lecture seule

Nombre total d’heures d’alimentation de cet appareil. Cette propriété est héritée de CIM _ LogicalDevice, mais elle n’est pas utilisée.

TransitioningToState

Type de données : UInt16

Type d'accès : Lecture seule

Indique l’État cible de la transition de l’instance. Cette propriété est héritée de CIM _ EnabledLogicalElement, mais elle n’est pas utilisée.

UncompressedDataRate

Type de données : UInt32

Type d'accès : Lecture seule

Taux de transfert de données soutenu, en Ko/s, que l’appareil peut lire et écrire sur un média. Il s’agit d’un débit de données brutes soutenu. Les taux ou taux maximaux en supposant que la compression ne doit pas être signalée dans cette propriété. Cette propriété est héritée de la _ MediaAccessDevice CIM.

UnitsDescription

Type de données : chaîne

Type d'accès : Lecture seule

Unités relatives à son utilisation dans MaxUnitsBeforeCleaning. Cette propriété est héritée de la _ MediaAccessDevice CIM.

UnitsUsed

Type de données : UInt64

Type d'accès : Lecture seule

Nombre actuel d’unités utilisées. Cette propriété est héritée de la _ MediaAccessDevice CIM.

UnloadTime

Type de données : UInt64

Type d'accès : Lecture seule

Durée, en millisecondes, de la possibilité de lire ou d’écrire un média dans son « déchargement ». Cette propriété est héritée de la _ MediaAccessDevice CIM.

Notes

L’accès à la classe MSVM _ DVDDrive peut être limité par le filtrage UAC. Pour plus d’informations, consultez contrôle de compte d’utilisateur et WMI.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Applications de [ Bureau Windows 8 uniquement]
Serveur minimal pris en charge
Applications de bureau Windows Server 2012 [ uniquement]
Espace de noms
\Virtualisation racine \ v2
MOF
WindowsVirtualization. v2. mof
DLL
Vmms.exe

Voir aussi

_DVDDRIVE CIM

_DVDDRIVE CIM

Classes de stockage