Msvm_DVDDrive, classe

  • Article

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 des lecteurs DE DVD virtuels et physiques peuvent être ajoutés et supprimés de la machine virtuelle, deux pools de ressources sont associés à cette classe, l’un pour les lecteurs de DVD pass-through 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 le code MOF (Managed Object Format) simplifié et inclut 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 a 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 ces propriétés.

Disponibilité supplémentaire

Type de données : uint16 array

Type d'accès : Lecture seule

Toute disponibilité et status supplémentaires de l’appareil. Cette propriété est héritée de CIM_LogicalDevice et est définie sur 6 (Non applicable).

Disponibilité

Type de données : uint16

Type d'accès : Lecture seule

Disponibilité principale et status de l’appareil. Cette propriété est héritée de CIM_LogicalDevice et est définie sur 6 (Non applicable).

AvailableRequestedStates

Type de données : uint16 array

Type d'accès : Lecture seule

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

Cette propriété est héritée de CIM_EnabledLogicalElement.

Capabilities

Type de données : uint32 array

Type d'accès : Lecture seule

Fonctionnalités de l’appareil d’accès au média. Cette propriété est héritée de CIM_MediaAccessDevice et elle est définie sur 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 « Supports multimédias 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 les fonctionnalités d’appareil d’accès 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 Capabilities , situé au même index. Cette propriété est héritée de CIM_MediaAccessDevice.

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 CIM_ManagedElement.

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 non 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 CIM_MediaAccessDevice.

« Non compressé »

« Inconnu »

« Compressé »

« 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’un 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 CIM_MediaAccessDevice.

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 CIM_ManagedElement.

DetailedStatus

Type de données : uint16

Type d'accès : Lecture seule

Complète la propriété PrimaryStatus avec des détails status 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_LogicalDevice et 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 CIM_ManagedElement.

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 CIM_EnabledLogicalElement.

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 CIM_EnabledLogicalElement.

ErrorCleared

Type de données : booléen

Type d'accès : Lecture seule

Indique si l’erreur signalée dans LastErrorCode est maintenant effacé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 plus d’informations sur l’erreur enregistrée dans LastErrorCode et des informations sur les actions correctives pouvant ê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 et de correction d’erreurs pris en charge par cet appareil. Cette propriété est héritée de CIM_MediaAccessDevice.

Formats pris en charge

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 CIM_DVDDrive.

Ce tableau contient les valeurs suivantes pour ISO.

{16, 22}

CD-ROM (16)

DVD (22)

Ce tableau contient les valeurs suivantes pour le passage physique.

Inconnu (0)

Autre (1)

CD-ROM (16)

CD-ROM/XA (17)

CD-I (18)

CD enregistrable (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 fonctionnel. 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 dans le tableau de propriétés OtherIdentifyingInfo . Cette propriété est héritée de CIM_LogicalDevice et 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 la machine virtuelle. 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 manière unique un instance de cette classe. Cette propriété est héritée de CIM_ManagedElement.

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 CIM_MediaAccessDevice.

LastErrorCode

Type de données : uint32

Type d'accès : Lecture seule

Dernier code d’erreur signalé par l’appareil 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

Temps, en millisecondes, entre le « chargement » et la possibilité de lire ou d’é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 (autrement dit, le disque tourne à des vitesses nominales). Pour les lecteurs de bande, il s’agit du moment entre l’injection d’un média et le signalement qu’il est prêt pour une application. Il s’agit généralement de la zone BOT de la bande. Cette propriété est héritée de CIM_MediaAccessDevice.

MaxAccessTime

Type de données : uint64

Type d'accès : Lecture seule

Temps, en millisecondes, pour passer du premier emplacement sur le support à l’emplacement le plus éloigné par rapport à l’heure. Pour un lecteur de disque, cela représente une recherche complète + un délai de rotation complet. Pour les lecteurs de bande, il s’agit d’une recherche 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 ce n’est pas nécessairement vrai.) Cette propriété est héritée de CIM_MediaAccessDevice.

MaxBlockSize

Type de données : uint64

Type d'accès : Lecture seule

Taille de bloc maximale, en octets, pour le média accessible par l’appareil. Cette propriété est héritée de CIM_MediaAccessDevice.

MaxMediaSize

Type de données : uint64

Type d'accès : Lecture seule

Taille maximale, en kilo-octets, du média pris en charge par cet appareil. Les kilo-octets sont interprétés comme le nombre d’octets multipliés par 1000 (et non le nombre d’octets multiplié par 1024). Cette propriété est héritée de CIM_MediaAccessDevice.

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

Nombre maximal d’unités pouvant être utilisées avant le nettoyage de l’appareil. Cette propriété est héritée de CIM_MediaAccessDevice.

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 CIM_MediaAccessDevice.

MinBlockSize

Type de données : uint64

Type d'accès : Lecture seule

Taille de bloc minimale, en octets, pour le média accessible par l’appareil. Cette propriété est héritée de CIM_MediaAccessDevice.

MountCount

Type de données : uint64

Type d'accès : Lecture seule

Pour un appareil qui prend en charge le support amovible, le nombre de fois que ce média a été monté pour le transfert de données ou pour propre l’appareil. Pour les appareils qui accèdent à des supports 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 CIM_MediaAccessDevice.

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_ManagedSystemElement et elle 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 multimédia doit être nettoyé ; sinon, False. Cette propriété est héritée de CIM_MediaAccessDevice.

NumberOfMediaSupported

Type de données : uint32

Type d'accès : Lecture seule

Nombre maximal de plusieurs supports individuels pouvant être pris en charge ou insérés. Cette propriété est héritée de CIM_MediaAccessDevice.

OperatingStatus

Type de données : uint16

Type d'accès : Lecture seule

Fournit des informations de status actuelles sur la condition opérationnelle de l’élément et peut être utilisée 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

État actuel 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 avoir la valeur Null lorsque la propriété EnabledState a une valeur autre que 1. Cette propriété est héritée de CIM_EnabledLogicalElement.

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 pourraient être utilisées pour identifier un appareil logique. Cette propriété est héritée de CIM_LogicalDevice et est définie sur Null.

PowerManagementCapabilities

Type de données : uint16 array

Type d'accès : Lecture seule

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é sur 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 pendant lesquelles cet appareil a été mis sous tension 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 de status de haut niveau. Cette propriété doit être utilisée conjointement avec la propriété DetailedStatus pour fournir des informations d’intégrité détaillées status 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 demandés et activés ou désactivés actuels. Un instance particulier de CIM_EnabledLogicalElement 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 CIM_EnabledLogicalElement.

Sécurité

Type de données : uint16

Type d'accès : Lecture seule

Sécurité opérationnelle définie pour l’appareil. Cette propriété est héritée de CIM_MediaAccessDevice.

État

Type de données : chaîne

Type d'accès : Lecture seule

Status actuelle 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 du 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’appareil 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 un média amovible, la date et l’heure les plus récentes auxquelles le média a été monté sur l’appareil. Pour les appareils qui accèdent à des supports non modifiables, 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 CIM_MediaAccessDevice.

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_EnabledLogicalElement et elle 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 un média amovible, la durée totale (en secondes) pendant laquelle le média a été monté pour le transfert de données ou pour propre l’appareil. Pour les appareils qui accèdent à des supports 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 CIM_MediaAccessDevice.

TotalPowerOnHours

Type de données : uint64

Type d'accès : Lecture seule

Nombre total d’heures pendant lesquelles cet appareil a été alimenté. 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 vers lequel le instance effectue la transition. 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 taux de données brut soutenu. Les taux maximaux ou les taux en supposant que la compression ne doit pas être signalée dans cette propriété. Cette propriété est héritée de CIM_MediaAccessDevice.

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 CIM_MediaAccessDevice.

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 CIM_MediaAccessDevice.

UnloadTime

Type de données : uint64

Type d'accès : Lecture seule

Temps, en millisecondes, entre la possibilité de lire ou d’écrire un média et son « déchargement ». Cette propriété est héritée de CIM_MediaAccessDevice.

Notes

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

Spécifications

Condition requise Valeur
Client minimal pris en charge
 Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge
 Windows Server 2012 [applications de bureau uniquement]
Espace de noms
 Root\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Voir aussi

CIM_DVDDrive

CIM_DVDDrive

Classes de stockage