Classe Msvm_DVDDrive

Artigo
06/12/2023

Representa uma unidade de DVD dentro de uma máquina virtual. Essa unidade de DVD pode ser um dispositivo de passagem (se um disco rígido físico foi anexado à máquina virtual) ou sintético e preenchido com mídia de arquivo ISO. Como unidades de DVD virtuais e físicas podem ser adicionadas e removidas da máquina virtual, há dois pools de recursos associados a essa classe, um para unidades de DVD de passagem e outro para unidades de DVD virtual. Unidades de DVD só poderão ser adicionadas ou removidas se a máquina virtual estiver offline.

A sintaxe a seguir é o código MOF (Managed Object Format) simplificado e inclui todas as propriedades herdadas.

Sintaxe

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

Membros

A classe Msvm_DVDDrive tem estes tipos de membros:

Métodos
Propriedades

Métodos

A classe Msvm_DVDDrive tem esses métodos.

Método	Descrição
EnableDevice	Não há suporte para o método.
LockMedia	Bloqueia ou libera a mídia.
OnlineDevice	Não há suporte para o método.
QuiesceDevice	Não há suporte para o método.
RequestStateChange	Solicita uma alteração de estado.
Redefinir	Redefine o dispositivo virtual.
RestoreProperties	Não há suporte para o método.
SaveProperties	Não há suporte para o método.
SetPowerState	Não há suporte para o método.

Propriedades

A classe Msvm_DVDDrive tem essas propriedades.

AdditionalAvailability

Tipo de dados: matriz uint16
Tipo de acesso: Somente leitura

Qualquer disponibilidade adicional e status do dispositivo. Essa propriedade é herdada de CIM_LogicalDevice e está definida como 6 (Não Aplicável).

Disponibilidade

Tipo de dados: uint16
Tipo de acesso: Somente leitura

A disponibilidade primária e status do dispositivo. Essa propriedade é herdada de CIM_LogicalDevice e está definida como 6 (Não Aplicável).

AvailableRequestedStates

Tipo de dados: matriz uint16
Tipo de acesso: Somente leitura

Indica os valores possíveis para o parâmetro RequestedState do método RequestStateChange usado para iniciar uma alteração de estado. Os valores listados serão um subconjunto dos valores contidos na propriedade RequestedStatesSupported da instância associada de CIM_EnabledLogicalElementCapabilities, em que os valores selecionados são uma função do estado atual do objeto CIM_EnabledLogicalElement . Essa propriedade poderá ser não Null se uma implementação for capaz de anunciar o conjunto de valores possíveis como uma função do estado atual. Essa propriedade será Null se uma implementação não puder determinar o conjunto de valores possíveis como uma função do estado atual.

Essa propriedade é herdada de CIM_EnabledLogicalElement.

Funcionalidades

Tipo de dados: matriz uint32
Tipo de acesso: Somente leitura

Os recursos do dispositivo de acesso à mídia. Essa propriedade é herdada de CIM_MediaAccessDevice e é definida com os valores a seguir.

Valor	Significado
{3, 7}
3	A entrada correspondente em CapabilityDescriptions é "Acesso Aleatório".
7	A entrada correspondente em CapabilityDescriptions é "Suporta mídia removível".

CapabilityDescriptions

Tipo de dados: matriz de cadeia de caracteres
Tipo de acesso: Somente leitura

Uma matriz de cadeias de caracteres de forma livre que fornece explicações detalhadas para acessar recursos de dispositivo indicados na matriz de propriedades Capabilities . Cada entrada dessa matriz está relacionada à entrada na matriz de propriedades Capabilities , localizada no mesmo índice. Essa propriedade é herdada de CIM_MediaAccessDevice.

Legenda

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Uma breve descrição do objeto. Essa propriedade é herdada de CIM_ManagedElement.

CommunicationStatus

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Indica a capacidade da instrumentação de se comunicar com o elemento gerenciado subjacente. Um valor Null indica que essa propriedade não está implementada. Essa propriedade é herdada de CIM_ManagedSystemElement.

CompressionMethod

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Uma cadeia de caracteres que indica o algoritmo ou a ferramenta usada para compactar o arquivo lógico. Se o esquema de compactação for desconhecido ou não descrito, use "Desconhecido". Se o arquivo lógico for compactado, mas o esquema de compactação for desconhecido ou não descrito, use "Compactado". Se o arquivo lógico não for compactado, use "Não compactado". Essa propriedade é herdada de CIM_MediaAccessDevice.

"Não compactado"

"Desconhecido"

"Compactado"

"Não compactado"

CreationClassName

Tipo de dados: uint16
Tipo de acesso: Somente leitura

O nome da classe ou subclasse usada na criação de uma instância. Essa propriedade é herdada de CIM_LogicalDevice.

DefaultBlockSize

Tipo de dados: uint64
Tipo de acesso: Somente leitura

O tamanho do bloco padrão, em bytes, para o dispositivo. Essa propriedade é herdada de CIM_MediaAccessDevice.

Descrição

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Uma descrição do objeto . Essa propriedade é herdada de CIM_ManagedElement.

DetailedStatus

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Complementa a propriedade PrimaryStatus com detalhes status adicionais. Um valor Null indica que essa propriedade não está implementada. Essa propriedade é herdada de CIM_ManagedSystemElement.

Deviceid

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Essa propriedade é herdada de CIM_LogicalDevice e é definida como "Microsoft:GUID\device-specific-data".

ElementName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Um nome de exibição para o objeto . Essa propriedade é herdada de CIM_ManagedElement.

EnabledDefault

Tipo de dados: uint16
Tipo de acesso: Somente leitura

A configuração padrão ou de inicialização de um administrador para o estado habilitado de um elemento. Essa propriedade é herdada de CIM_EnabledLogicalElement.

EnabledState

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Os estados habilitados e desabilitados de um elemento. Ele também pode indicar as transições entre esses estados solicitados. Essa propriedade é herdada de CIM_EnabledLogicalElement.

ErrorCleared

Tipo de dados: booliano
Tipo de acesso: Somente leitura

Indica se o erro relatado em LastErrorCode agora está limpo. Essa propriedade é herdada de CIM_LogicalDevice, mas não é usada.

ErrorDescription

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Uma cadeia de caracteres que fornece mais informações sobre o erro registrado em LastErrorCode e informações sobre as ações corretivas que podem ser executadas. Essa propriedade é herdada de CIM_LogicalDevice, mas não é usada.

ErrorMethodology

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Uma cadeia de caracteres que descreve os tipos de detecção e correção de erros compatíveis com esse dispositivo. Essa propriedade é herdada de CIM_MediaAccessDevice.

FormatsSupported

Tipo de dados: matriz uint16
Tipo de acesso: Somente leitura

Os formatos de CD e DVD compatíveis com este dispositivo. Essa propriedade é herdada de CIM_DVDDrive.

Essa matriz contém os valores a seguir para ISO.

{16, 22}
CD-ROM (16)
DVD (22)

Essa matriz contém os valores a seguir para passagem física.

Desconhecido (0)
Outros (1)
CD-ROM (16)
CD-ROM/XA (17)
CD-I (18)
Cd Recordable (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 gravável (36)
DVD-RW (37)
DVD-Audio (38)
DVD-5 (39)
DVD-9 (40)
DVD-10 (41)
DVD-18 (42)

HealthState

Tipo de dados: uint16
Tipo de acesso: Somente leitura

A integridade atual do elemento. Esse atributo expressa a integridade desse elemento, mas não necessariamente a de seus subcomponentes. Os valores possíveis são de 0 a 30, em que 5 significa que o elemento está totalmente íntegro e 30 significa que o elemento é completamente não funcional. Essa propriedade é herdada de CIM_ManagedSystemElement.

IdentifyingDescriptions

Tipo de dados: matriz de cadeia de caracteres
Tipo de acesso: Somente leitura

Uma matriz de cadeias de caracteres de forma livre que fornecem explicações e detalhes por trás das entradas na matriz de propriedades OtherIdentifyingInfo . Essa propriedade é herdada de CIM_LogicalDevice e está definida como Null.

InstallDate

Tipo de dados: datetime
Tipo de acesso: Somente leitura

A data e a hora em que a configuração da máquina virtual foi criada. Essa propriedade é herdada de CIM_ManagedSystemElement.

InstanceID

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Chave

Identifica exclusivamente uma instância dessa classe. Essa propriedade é herdada de CIM_ManagedElement.

LastCleaned

Tipo de dados: datetime
Tipo de acesso: Somente leitura

A data e a hora em que o dispositivo foi limpo pela última vez. Essa propriedade é herdada de CIM_MediaAccessDevice.

LastErrorCode

Tipo de dados: uint32
Tipo de acesso: Somente leitura

O último código de erro relatado pelo dispositivo lógico. Essa propriedade é herdada de CIM_LogicalDevice, mas não é usada.

LoadTime

Tipo de dados: uint64
Tipo de acesso: Somente leitura

O tempo, em milissegundos, de "carregar" a ser capaz de ler ou gravar uma mídia. Por exemplo, para unidades de disco, esse é o intervalo entre um disco que não está girando para o relatório de disco que ele está pronto para leitura/gravação (ou seja, o disco girando em velocidades nominais). Para unidades de fita, esse é o momento de uma mídia ser injetada para relatar que ela está pronta para um aplicativo. Isso geralmente está na área de BOT da fita. Essa propriedade é herdada de CIM_MediaAccessDevice.

MaxAccessTime

Tipo de dados: uint64
Tipo de acesso: Somente leitura

O tempo, em milissegundos, para passar do primeiro local na mídia para o local mais distante em relação ao tempo. Para uma unidade de disco, isso representa a busca completa + atraso rotacional completo. Para unidades de fita, isso representa uma pesquisa desde o início da fita até o ponto mais fisicamente distante. (O final de uma fita pode estar em seu ponto mais fisicamente distante, mas isso não é necessariamente verdadeiro.) Essa propriedade é herdada de CIM_MediaAccessDevice.

MaxBlockSize

Tipo de dados: uint64
Tipo de acesso: Somente leitura

O tamanho máximo do bloco, em bytes, para mídia acessada pelo dispositivo. Essa propriedade é herdada de CIM_MediaAccessDevice.

MaxMediaSize

Tipo de dados: uint64
Tipo de acesso: Somente leitura

O tamanho máximo, em quilobytes, da mídia compatível com este dispositivo. Os quilobytes são interpretados como o número de bytes multiplicado por 1000 (não o número de bytes multiplicados por 1024). Essa propriedade é herdada de CIM_MediaAccessDevice.

MaxQuiesceTime

Tipo de dados: uint64
Tipo de acesso: Somente leitura

Essa propriedade foi substituída. Essa propriedade é herdada de CIM_LogicalDevice, mas não é usada.

MaxUnitsBeforeCleaning

Tipo de dados: uint64
Tipo de acesso: Somente leitura

As unidades máximas que podem ser usadas antes do dispositivo devem ser limpas. Essa propriedade é herdada de CIM_MediaAccessDevice.

MediaIsLocked

Tipo de dados: booliano
Tipo de acesso: Somente leitura

True se a mídia estiver bloqueada no dispositivo e não puder ser ejetada; caso contrário, False. Essa propriedade é herdada de CIM_MediaAccessDevice.

MinBlockSize

Tipo de dados: uint64
Tipo de acesso: Somente leitura

O tamanho mínimo do bloco, em bytes, para mídia acessada pelo dispositivo. Essa propriedade é herdada de CIM_MediaAccessDevice.

MountCount

Tipo de dados: uint64
Tipo de acesso: Somente leitura

Para um dispositivo que dá suporte à mídia removível, o número de vezes que a mídia foi montada para transferência de dados ou para limpo o dispositivo. Para dispositivos que acessam mídia não móvel, como discos rígidos, essa propriedade não é aplicável e deve ser definida como 0. Essa propriedade é herdada de CIM_MediaAccessDevice.

Nome

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

O rótulo pelo qual o objeto é conhecido. Essa propriedade é herdada de CIM_ManagedSystemElement e é igual à propriedade ElementName .

NeedsCleaning

Tipo de dados: booliano
Tipo de acesso: Somente leitura

True se o dispositivo de acesso à mídia precisar de limpeza; caso contrário, False. Essa propriedade é herdada de CIM_MediaAccessDevice.

NumberOfMediaSupported

Tipo de dados: uint32
Tipo de acesso: Somente leitura

O número máximo de várias mídias individuais que podem ser suportadas ou inseridas. Essa propriedade é herdada de CIM_MediaAccessDevice.

OperatingStatus

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Fornece informações de status atuais para a condição operacional do elemento e pode ser usado para fornecer mais detalhes em relação ao valor da propriedade EnabledState. Um valor Null indica que essa propriedade não está implementada. Essa propriedade é herdada de CIM_ManagedSystemElement.

OperationalStatus

Tipo de dados: matriz uint16
Tipo de acesso: Somente leitura

Os status atuais do objeto. Essa propriedade é herdada de CIM_ManagedSystemElement.

OtherEnabledState

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

O estado habilitado ou desabilitado do elemento quando a propriedade EnabledState é definida como 1 (Outros). Essa propriedade deve ser definida como Null quando a propriedade EnabledState for qualquer valor diferente de 1. Essa propriedade é herdada de CIM_EnabledLogicalElement.

OtherIdentifyingInfo

Tipo de dados: matriz de cadeia de caracteres
Tipo de acesso: Somente leitura

Quaisquer dados adicionais, além das informações de ID do dispositivo, que podem ser usados para identificar um dispositivo lógico. Essa propriedade é herdada de CIM_LogicalDevice e está definida como Null.

PowerManagementCapabilities

Tipo de dados: matriz uint16
Tipo de acesso: Somente leitura

Os recursos de gerenciamento de energia do dispositivo. Essa propriedade é herdada de CIM_LogicalDevice, mas não é usada.

PowerManagementSupported

Tipo de dados: booliano
Tipo de acesso: Somente leitura

Indica se o dispositivo pode ser gerenciado por energia. Essa propriedade é herdada de CIM_LogicalDevice, mas não é usada.

PowerOnHours

Tipo de dados: uint64
Tipo de acesso: Somente leitura

O número de horas consecutivas em que este dispositivo foi ligado desde seu último ciclo de energia. Essa propriedade é herdada de CIM_LogicalDevice, mas não é usada.

PrimaryStatus

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Fornece informações de status de alto nível. Essa propriedade deve ser usada em conjunto com a propriedade DetailedStatus para fornecer informações de status de integridade detalhadas e de alto nível para o elemento e seus subcomponentes. Um valor Null indica que essa propriedade não está implementada. Essa propriedade é herdada de CIM_ManagedSystemElement.

RequestedState

Tipo de dados: uint16
Tipo de acesso: Somente leitura

O último estado solicitado ou desejado para o elemento. O estado real do elemento é representado pela propriedade EnabledState . Essa propriedade é fornecida para comparar os últimos estados solicitados e atuais habilitados ou desabilitados. Uma instância específica do CIM_EnabledLogicalElement pode não dar suporte ao método RequestStateChange . Se isso ocorrer, o valor 12 (Não Aplicável) será usado. Essa propriedade é herdada de CIM_EnabledLogicalElement.

Segurança

Tipo de dados: uint16
Tipo de acesso: Somente leitura

A segurança operacional definida para o dispositivo. Essa propriedade é herdada de CIM_MediaAccessDevice.

Status

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

O status atual do objeto . Essa propriedade é herdada de CIM_ManagedSystemElement, mas não é usada.

StatusDescriptions

Tipo de dados: matriz de cadeia de caracteres
Tipo de acesso: Somente leitura

Cadeias de caracteres que descrevem os vários valores de matriz OperationalStatus . Essa propriedade é herdada de CIM_ManagedSystemElement.

StatusInfo

Tipo de dados: uint16
Tipo de acesso: Somente leitura

O estado atual do dispositivo lógico. Essa propriedade é herdada de CIM_LogicalDevice, mas não é usada.

SystemCreationClassName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

O nome da classe de criação do sistema de escopo. Essa propriedade é herdada de CIM_LogicalDevice.

Systemname

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

O identificador exclusivo para a máquina virtual de escopo. Essa propriedade é herdada de CIM_LogicalDevice.

TimeOfLastMount

Tipo de dados: datetime
Tipo de acesso: Somente leitura

Para um dispositivo que dá suporte a mídia removível, a data e hora mais recentes em que a mídia foi montada no dispositivo. Para dispositivos que acessam mídia não móvel, como discos rígidos, essa propriedade não tem significado e não é aplicável. Essa propriedade é herdada de CIM_MediaAccessDevice.

TimeOfLastStateChange

Tipo de dados: datetime
Tipo de acesso: Somente leitura

A data ou hora em que o estado habilitado do elemento foi alterado pela última vez. Essa propriedade é herdada de CIM_EnabledLogicalElement e é sempre definida como Null.

TotalMountTime

Tipo de dados: uint64
Tipo de acesso: Somente leitura

Para um dispositivo que dá suporte a mídia removível, o tempo total (em segundos) que a mídia foi montada para transferência de dados ou para limpo o dispositivo. Para dispositivos que acessam mídia não móvel, como discos rígidos, essa propriedade não é aplicável e deve ser definida como 0. Essa propriedade é herdada de CIM_MediaAccessDevice.

TotalPowerOnHours

Tipo de dados: uint64
Tipo de acesso: Somente leitura

O número total de horas que este dispositivo foi alimentado. Essa propriedade é herdada de CIM_LogicalDevice, mas não é usada.

TransitioningToState

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Indica o estado de destino para o qual a instância está em transição. Essa propriedade é herdada de CIM_EnabledLogicalElement, mas não é usada.

UncompressedDataRate

Tipo de dados: uint32
Tipo de acesso: Somente leitura

A taxa de transferência de dados sustentada, em KB/s, da qual o dispositivo pode ler e gravar em uma mídia. Essa é uma taxa de dados brutos sustentada. Taxas máximas ou taxas supondo que a compactação não deve ser relatada nesta propriedade. Essa propriedade é herdada de CIM_MediaAccessDevice.

UnitsDescription

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

As unidades relativas ao seu uso em MaxUnitsBeforeCleaning. Essa propriedade é herdada de CIM_MediaAccessDevice.

UnitsUsed

Tipo de dados: uint64
Tipo de acesso: Somente leitura

O número atual de unidades usadas. Essa propriedade é herdada de CIM_MediaAccessDevice.

UnloadTime

Tipo de dados: uint64
Tipo de acesso: Somente leitura

O tempo, em milissegundos, de ser capaz de ler ou escrever uma mídia para seu "descarregamento". Essa propriedade é herdada de CIM_MediaAccessDevice.

Comentários

O acesso à classe Msvm_DVDDrive pode ser restrito pela Filtragem UAC. Para obter mais informações, consulte Controle de Conta de Usuário e WMI.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Namespace	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Confira também

CIM_DVDDrive
CIM_DVDDrive
Classes de armazenamento

Compartilhar via

Classe Msvm_DVDDrive

Sintaxe

Membros

Métodos

Propriedades

Comentários

Requisitos

Confira também

Comentários

Recursos adicionais