Clase Msvm_DVDDrive
Representa una unidad de DVD dentro de una máquina virtual. Esta unidad de DVD puede ser un dispositivo de paso a través (si un disco duro físico se ha conectado a la máquina virtual) o sintético y se rellena con medios de archivo ISO. Dado que las unidades de DVD virtuales y físicas se pueden agregar y quitar de la máquina virtual, hay dos grupos de recursos asociados a esta clase, uno para las unidades de DVD de paso a través y el otro para las unidades de DVD virtuales. Las unidades de DVD solo se pueden agregar o quitar si la máquina virtual está sin conexión.
La siguiente sintaxis es código de Formato de objeto administrado (MOF) simplificado e incluye todas las propiedades heredadas.
Sintaxis
[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};
};
Miembros
La clase Msvm_DVDDrive tiene estos tipos de miembros:
Métodos
La clase Msvm_DVDDrive tiene estos métodos.
| Método | Descripción |
|---|---|
| EnableDevice | No se admite este método. |
| LockMedia | Bloquea o libera el medio. |
| OnlineDevice | No se admite este método. |
| QuiesceDevice | No se admite este método. |
| RequestStateChange | Solicita un cambio de estado. |
| Restablecer | Restablece el dispositivo virtual. |
| RestoreProperties | No se admite este método. |
| SaveProperties | No se admite este método. |
| SetPowerState | No se admite este método. |
Propiedades
La clase Msvm_DVDDrive tiene estas propiedades.
-
AdditionalAvailability
-
-
Tipo de datos: matriz uint16
-
Tipo de acceso: solo lectura
Cualquier disponibilidad y estado adicionales del dispositivo. Esta propiedad se hereda de CIM_LogicalDevice y se establece en 6 (no aplicable).
-
-
Disponibilidad
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
La disponibilidad principal y el estado del dispositivo. Esta propiedad se hereda de CIM_LogicalDevice y se establece en 6 (no aplicable).
-
-
AvailableRequestedStates
-
-
Tipo de datos: matriz uint16
-
Tipo de acceso: solo lectura
Indica los valores posibles para el parámetro RequestedState del método RequestStateChange utilizado para iniciar un cambio de estado. Los valores enumerados serán un subconjunto de los valores contenidos en la propiedad RequestedStatesSupported de la instancia asociada de CIM_EnabledLogicalElementCapabilities, donde los valores seleccionados son una función del estado actual del objeto CIM_EnabledLogicalElement . Esta propiedad puede ser distinta de Null si una implementación puede anunciar el conjunto de valores posibles como una función del estado actual. Esta propiedad será Null si una implementación no puede determinar el conjunto de valores posibles como una función del estado actual.
Esta propiedad se hereda de CIM_EnabledLogicalElement.
-
-
Capabilities
-
-
Tipo de datos: matriz uint32
-
Tipo de acceso: solo lectura
Funcionalidades del dispositivo de acceso multimedia. Esta propiedad se hereda de CIM_MediaAccessDevice y se establece en los valores siguientes.
Valor Significado - {3, 7}
- 3
La entrada correspondiente en CapabilityDescriptions es "Acceso aleatorio". - 7
La entrada correspondiente en CapabilityDescriptions es "Admite medios extraíbles". -
-
CapabilityDescriptions
-
-
Tipo de datos: matriz de cadenas
-
Tipo de acceso: solo lectura
Matriz de cadenas de forma libre que proporciona explicaciones detalladas sobre las características del dispositivo de acceso indicadas en la matriz de propiedades Capabilities . Cada entrada de esta matriz está relacionada con la entrada de la matriz de propiedades Capabilities , ubicada en el mismo índice. Esta propiedad se hereda de CIM_MediaAccessDevice.
-
-
Caption
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Descripción breve del objeto. Esta propiedad se hereda de CIM_ManagedElement.
-
-
CommunicationStatus
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
Indica la capacidad de la instrumentación para comunicarse con el elemento administrado subyacente. Un valor Null indica que esta propiedad no está implementada. Esta propiedad se hereda de CIM_ManagedSystemElement.
-
-
CompressionMethod
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Cadena que indica el algoritmo o la herramienta que se usa para comprimir el archivo lógico. Si el esquema de compresión es desconocido o no se describe, use "Unknown". Si el archivo lógico está comprimido, pero el esquema de compresión es desconocido o no se describe, use "Comprimido". Si el archivo lógico no está comprimido, use "Not Compressed". Esta propiedad se hereda de CIM_MediaAccessDevice.
"No comprimido"
"Desconocido"
"Comprimido"
"No comprimido"
-
-
CreationClassName
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
Nombre de la clase o subclase usada en la creación de una instancia. Esta propiedad se hereda de CIM_LogicalDevice.
-
-
DefaultBlockSize
-
-
Tipo de datos: uint64
-
Tipo de acceso: solo lectura
Tamaño de bloque predeterminado, en bytes, para el dispositivo. Esta propiedad se hereda de CIM_MediaAccessDevice.
-
-
Descripción
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Descripción del objeto. Esta propiedad se hereda de CIM_ManagedElement.
-
-
DetailedStatus
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
Complementa la propiedad PrimaryStatus con detalles de estado adicionales. Un valor Null indica que esta propiedad no está implementada. Esta propiedad se hereda de CIM_ManagedSystemElement.
-
-
Deviceid
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Esta propiedad se hereda de CIM_LogicalDevice y se establece en "Microsoft:GUID\device-specific-data".
-
-
ElementName
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Nombre para mostrar del objeto. Esta propiedad se hereda de CIM_ManagedElement.
-
-
EnabledDefault
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
Configuración de inicio o predeterminada de un administrador para el estado habilitado de un elemento. Esta propiedad se hereda de CIM_EnabledLogicalElement.
-
-
EnabledState
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
Estados habilitados y deshabilitados de un elemento. También puede indicar las transiciones entre estos estados solicitados. Esta propiedad se hereda de CIM_EnabledLogicalElement.
-
-
ErrorCleared
-
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
Indica si el error notificado en LastErrorCode ahora está borrado. Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.
-
-
ErrorDescription
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Cadena que proporciona más información sobre el error registrado en LastErrorCode e información sobre las acciones correctivas que se pueden realizar. Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.
-
-
ErrorMethodology
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Cadena que describe los tipos de detección y corrección de errores admitidos por este dispositivo. Esta propiedad se hereda de CIM_MediaAccessDevice.
-
-
FormatsSupported
-
-
Tipo de datos: matriz uint16
-
Tipo de acceso: solo lectura
Formatos de CD y DVD compatibles con este dispositivo. Esta propiedad se hereda de CIM_DVDDrive.
Esta matriz contiene los siguientes valores para ISO.
-
{16, 22}
-
CD-ROM (16)
-
DVD (22)
Esta matriz contiene los valores siguientes para el paso a través físico.
-
Desconocido (0)
-
Otros (1)
-
CD-ROM (16)
-
CD-ROM/XA (17)
-
CD-I (18)
-
CD Grabable (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 grabable (36)
-
DVD-RW (37)
-
DVD-Audio (38)
-
DVD-5 (39)
-
DVD-9 (40)
-
DVD-10 (41)
-
DVD-18 (42)
-
-
HealthState
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
Estado actual del elemento. Este atributo expresa el estado de este elemento, pero no necesariamente el de sus subcomponentes. Los valores posibles son de 0 a 30, donde 5 significa que el elemento es completamente correcto y 30 significa que el elemento no funciona completamente. Esta propiedad se hereda de CIM_ManagedSystemElement.
-
-
IdentifyingDescriptions
-
-
Tipo de datos: matriz de cadenas
-
Tipo de acceso: solo lectura
Matriz de cadenas de forma libre que proporcionan explicaciones y detalles detrás de las entradas de la matriz de propiedades OtherIdentifyingInfo . Esta propiedad se hereda de CIM_LogicalDevice y se establece en Null.
-
-
InstallDate
-
-
Tipo de datos: datetime
-
Tipo de acceso: solo lectura
Fecha y hora en que se creó la configuración de la máquina virtual. Esta propiedad se hereda de CIM_ManagedSystemElement.
-
-
InstanceID
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: Clave
Identifica de forma única una instancia de esta clase. Esta propiedad se hereda de CIM_ManagedElement.
-
-
LastCleaned
-
-
Tipo de datos: datetime
-
Tipo de acceso: solo lectura
Fecha y hora en que se limpió por última vez el dispositivo. Esta propiedad se hereda de CIM_MediaAccessDevice.
-
-
LastErrorCode
-
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
El último código de error notificado por el dispositivo lógico. Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.
-
-
LoadTime
-
-
Tipo de datos: uint64
-
Tipo de acceso: solo lectura
El tiempo, en milisegundos, de "carga" para poder leer o escribir un medio. Por ejemplo, para las unidades de disco, este es el intervalo entre un disco que no gira en el disco que informa de que está listo para lectura y escritura (es decir, el disco gira a velocidades nominales). En el caso de las unidades de cinta, este es el momento de insertar un medio para informar de que está listo para una aplicación. Esto suele estar en el área BOT de la cinta. Esta propiedad se hereda de CIM_MediaAccessDevice.
-
-
MaxAccessTime
-
-
Tipo de datos: uint64
-
Tipo de acceso: solo lectura
La hora, en milisegundos, para pasar de la primera ubicación del medio a la ubicación más lejana con respecto al tiempo. Para una unidad de disco, esto representa la búsqueda completa + retraso rotacional completo. En el caso de las unidades de cinta, representa una búsqueda desde el principio de la cinta hasta el punto más distante físicamente. (El final de una cinta puede estar en su punto más lejano físicamente, pero esto no es necesariamente cierto). Esta propiedad se hereda de CIM_MediaAccessDevice.
-
-
MaxBlockSize
-
-
Tipo de datos: uint64
-
Tipo de acceso: solo lectura
Tamaño máximo de bloque, en bytes, para los medios a los que accede el dispositivo. Esta propiedad se hereda de CIM_MediaAccessDevice.
-
-
MaxMediaSize
-
-
Tipo de datos: uint64
-
Tipo de acceso: solo lectura
Tamaño máximo, en kilobytes, de medios admitidos por este dispositivo. Los kilobytes se interpretan como el número de bytes multiplicados por 1000 (no el número de bytes multiplicados por 1024). Esta propiedad se hereda de CIM_MediaAccessDevice.
-
-
MaxQuiesceTime
-
-
Tipo de datos: uint64
-
Tipo de acceso: solo lectura
Esta propiedad está en desuso. Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.
-
-
MaxUnitsBeforeCleaning
-
-
Tipo de datos: uint64
-
Tipo de acceso: solo lectura
Unidades máximas que se pueden usar antes de limpiar el dispositivo. Esta propiedad se hereda de CIM_MediaAccessDevice.
-
-
MediaIsLocked
-
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
True si el medio está bloqueado en el dispositivo y no se puede expulsar; de lo contrario, False. Esta propiedad se hereda de CIM_MediaAccessDevice.
-
-
MinBlockSize
-
-
Tipo de datos: uint64
-
Tipo de acceso: solo lectura
Tamaño mínimo de bloque, en bytes, para los medios a los que accede el dispositivo. Esta propiedad se hereda de CIM_MediaAccessDevice.
-
-
MountCount
-
-
Tipo de datos: uint64
-
Tipo de acceso: solo lectura
En el caso de un dispositivo que admita medios extraíbles, el número de veces que los medios se han montado para la transferencia de datos o para limpiar el dispositivo. Para los dispositivos que acceden a medios no extraíbles, como los discos duros, esta propiedad no es aplicable y debe establecerse en 0. Esta propiedad se hereda de CIM_MediaAccessDevice.
-
-
Nombre
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Etiqueta por la que se conoce el objeto. Esta propiedad se hereda de CIM_ManagedSystemElement y es la misma que la propiedad ElementName .
-
-
NeedsCleaning
-
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
True si el dispositivo de acceso multimedia necesita limpieza; de lo contrario, False. Esta propiedad se hereda de CIM_MediaAccessDevice.
-
-
NumberOfMediaSupported
-
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
Número máximo de varios medios individuales que se pueden admitir o insertar. Esta propiedad se hereda de CIM_MediaAccessDevice.
-
-
OperatingStatus
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
Proporciona información de estado actual para la condición operativa del elemento y se puede usar para proporcionar más detalles con respecto al valor de la propiedad EnabledState . Un valor Null indica que esta propiedad no está implementada. Esta propiedad se hereda de CIM_ManagedSystemElement.
-
-
OperationalStatus
-
-
Tipo de datos: matriz uint16
-
Tipo de acceso: solo lectura
Estados actuales del objeto . Esta propiedad se hereda de CIM_ManagedSystemElement.
-
-
OtherEnabledState
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Estado habilitado o deshabilitado del elemento cuando la propiedad EnabledState está establecida en 1 (Other). Esta propiedad debe establecerse en Null cuando la propiedad EnabledState es cualquier valor distinto de 1. Esta propiedad se hereda de CIM_EnabledLogicalElement.
-
-
OtherIdentifyingInfo
-
-
Tipo de datos: matriz de cadenas
-
Tipo de acceso: solo lectura
Cualquier dato adicional, más allá de la información del identificador de dispositivo, que se podría usar para identificar un dispositivo lógico. Esta propiedad se hereda de CIM_LogicalDevice y se establece en Null.
-
-
PowerManagementCapabilities
-
-
Tipo de datos: matriz uint16
-
Tipo de acceso: solo lectura
Las funcionalidades de administración de energía del dispositivo. Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.
-
-
PowerManagementSupported
-
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
Indica si el dispositivo se puede administrar con energía. Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.
-
-
PowerOnHours
-
-
Tipo de datos: uint64
-
Tipo de acceso: solo lectura
Número de horas consecutivas que este dispositivo se ha encendido desde su último ciclo de alimentación. Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.
-
-
PrimaryStatus
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
Proporciona información de estado de alto nivel. Esta propiedad debe usarse junto con la propiedad DetailedStatus para proporcionar información de estado de mantenimiento detallada y de alto nivel para el elemento y sus subcomponentes. Un valor Null indica que esta propiedad no está implementada. Esta propiedad se hereda de CIM_ManagedSystemElement.
-
-
RequestedState
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
El último estado solicitado o deseado para el elemento. El estado real del elemento se representa mediante la propiedad EnabledState . Esta propiedad se proporciona para comparar los últimos estados solicitados y habilitados o deshabilitados actuales. Es posible que una instancia determinada de CIM_EnabledLogicalElement no admita el método RequestStateChange . Si esto ocurre, se usa el valor 12 (no aplicable). Esta propiedad se hereda de CIM_EnabledLogicalElement.
-
-
Seguridad
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
La seguridad operativa definida para el dispositivo. Esta propiedad se hereda de CIM_MediaAccessDevice.
-
-
Estado
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Estado actual del objeto. Esta propiedad se hereda de CIM_ManagedSystemElement, pero no se usa.
-
-
StatusDescriptions
-
-
Tipo de datos: matriz de cadenas
-
Tipo de acceso: solo lectura
Cadenas que describen los distintos valores de matriz OperationalStatus . Esta propiedad se hereda de CIM_ManagedSystemElement.
-
-
StatusInfo
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
Estado actual del dispositivo lógico. Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.
-
-
SystemCreationClassName
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Nombre de clase de creación del sistema de ámbito. Esta propiedad se hereda de CIM_LogicalDevice.
-
-
SystemName
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Identificador único de la máquina virtual de ámbito. Esta propiedad se hereda de CIM_LogicalDevice.
-
-
TimeOfLastMount
-
-
Tipo de datos: datetime
-
Tipo de acceso: solo lectura
En el caso de un dispositivo que admita medios extraíbles, la fecha y hora más recientes en que se montó el medio en el dispositivo. Para los dispositivos que acceden a medios no extraíbles, como los discos duros, esta propiedad no tiene ningún significado y no es aplicable. Esta propiedad se hereda de CIM_MediaAccessDevice.
-
-
TimeOfLastStateChange
-
-
Tipo de datos: datetime
-
Tipo de acceso: solo lectura
Fecha u hora en que el estado habilitado del elemento cambió por última vez. Esta propiedad se hereda de CIM_EnabledLogicalElement y siempre se establece en Null.
-
-
TotalMountTime
-
-
Tipo de datos: uint64
-
Tipo de acceso: solo lectura
Para un dispositivo que admite medios extraíbles, el tiempo total (en segundos) que los medios se han montado para la transferencia de datos o para limpiar el dispositivo. Para los dispositivos que acceden a medios no extraíbles, como los discos duros, esta propiedad no es aplicable y debe establecerse en 0. Esta propiedad se hereda de CIM_MediaAccessDevice.
-
-
TotalPowerOnHours
-
-
Tipo de datos: uint64
-
Tipo de acceso: solo lectura
Número total de horas que este dispositivo se ha encendido. Esta propiedad se hereda de CIM_LogicalDevice, pero no se usa.
-
-
TransitioningToState
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
Indica el estado de destino al que se está realizando la transición de la instancia. Esta propiedad se hereda de CIM_EnabledLogicalElement, pero no se usa.
-
-
UncompressedDataRate
-
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
Velocidad de transferencia de datos sostenida, en KB/s, que el dispositivo puede leer y escribir en un medio. Se trata de una tasa de datos sin procesar sostenida. No se deben notificar las tasas máximas ni las tasas suponiendo que la compresión se notifique en esta propiedad. Esta propiedad se hereda de CIM_MediaAccessDevice.
-
-
UnitsDescription
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Unidades relativas a su uso en MaxUnitsBeforeCleaning. Esta propiedad se hereda de CIM_MediaAccessDevice.
-
-
UnitsUsed
-
-
Tipo de datos: uint64
-
Tipo de acceso: solo lectura
Número actual de unidades usadas. Esta propiedad se hereda de CIM_MediaAccessDevice.
-
-
UnloadTime
-
-
Tipo de datos: uint64
-
Tipo de acceso: solo lectura
La hora, en milisegundos, de ser capaz de leer o escribir un medio en su "descarga". Esta propiedad se hereda de CIM_MediaAccessDevice.
-
Comentarios
El acceso a la clase Msvm_DVDDrive puede estar restringido por el filtrado de UAC. Para obtener más información, consulte Control de cuentas de usuario y WMI.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2012 [solo aplicaciones de escritorio] |
| Espacio de nombres |
Root\Virtualization\V2 |
| MOF |
|
| Archivo DLL |
|
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de