Classe Msvm_SerialController

Artigo
06/13/2023

Representa os recursos e o gerenciamento do controlador serial. Os controladores serial são dispositivos lógicos que estão sempre presentes em uma máquina virtual e, portanto, não são alocados por meio de um pool de recursos. Uma instância de controlador serial está sempre presente em uma máquina virtual. Os controladores serial têm um número fixo de instâncias de porta. Essa implementação dá suporte a duas portas por controlador.

Observação

Os controladores serial são opcionais em máquinas virtuais de geração 2.

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_SerialController : CIM_SerialController
{
  string   InstanceID;
  string   Caption = "Serial Controller";
  string   Description = "Microsoft Virtual Serial Controller";
  string   ElementName = "Serial Controller";
  datetime InstallDate;
  string   Name = "Serial Controller";
  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;
  string   CreationClassName = "Msvm_SerialController";
  string   DeviceID;
  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;
  datetime TimeOfLastReset;
  uint16   ProtocolSupported = 26;
  uint32   MaxNumberControlled = 2;
  string   ProtocolDescription;
  uint16   Capabilities[] = { 5 };
  string   CapabilityDescriptions[] = { "16550 compatible" };
  uint32   MaxBaudRate = 115200;
  uint16   Security = 3;
};

Membros

A classe Msvm_SerialController tem esses tipos de membros:

Métodos
Propriedades

Métodos

A classe Msvm_SerialController tem esses métodos.

Método	Descrição
EnableDevice	Não há suporte para o método.
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.
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_SerialController 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.

Valor	Significado
{ 6 }
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.

Valor	Significado
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 . Essa propriedade é herdada de CIM_EnabledLogicalElement, mas não é usada.

Funcionalidades

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

O buffer e outros recursos do controlador serial que podem ser inerentes ao hardware do chip. Essa propriedade é herdada de CIM_SerialController.

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 mais detalhadas para qualquer um dos recursos do controlador serial indicados na matriz Capabilities . Essa propriedade é herdada de CIM_SerialController.

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.

Desconhecido (0)
Não disponível (1)
Comunicação OK (2)
Comunicação Perdida (3)
Sem Contato (4)
DMTF Reservado (..)
Fornecedor Reservado (0x8000.. )

CreationClassName

Tipo de dados: cadeia de caracteres
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.

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 adicionais de status. Um valor Null indica que essa propriedade não está implementada. Essa propriedade é herdada de CIM_ManagedSystemElement.

Não disponível (0)
Nenhuma informação adicional (1)
Estressado (2)
Falha preditiva (3)
Erro não recuperável (4)
Entidade de suporte em erro (5)
DMTF Reservado (..)
Fornecedor Reservado (0x8000.. )

Deviceid

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

Essa propriedade é herdada de CIM_LogicalDevice e sempre é definida como "Microsoft:<GUID>".

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

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

Valor	Significado
2	habilitado

EnabledState

Tipo de dados: uint16
Tipo de acesso: Somente leitura

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

Valor	Significado
5	Não Aplicável

ErrorCleared

Tipo de dados: booliano
Tipo de acesso: Somente leitura

Indica se o erro relatado na propriedade 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 na propriedade LastErrorCode e informações sobre quaisquer ações corretivas que possam ser executadas. Essa propriedade é herdada de CIM_LogicalDevice, mas não é usada.

HealthState

Tipo de dados: uint16
Tipo de acesso: Somente leitura

A integridade atual do elemento. Isso 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 é sempre 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.

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.

MaxBaudRate

Tipo de dados: uint32
Tipo de acesso: Somente leitura

A taxa máxima de baud, em bits por segundo, que é compatível com o controlador serial. Essa propriedade é herdada de CIM_SerialController.

MaxNumberControlled

Tipo de dados: uint32
Tipo de acesso: Somente leitura

O número máximo de entidades endereçáveis diretamente compatíveis com esse controlador. Um valor de 0 deverá ser usado se o número for desconhecido ou ilimitado. O protocolo usado pelo controlador para acessar dispositivos controlados. Essa propriedade é herdada de CIM_Controller.

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.

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 .

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.

Desconhecido (0)
Não disponível (1)
Manutenção (2)
Começando (3)
Parando (4)
Parado (5)
Anulado (6)
Dormente (7)
Concluído (8)
Migrando (9)
Emigrando (10)
Imigração (11)
Instantâneo (12)
Desligar (13)
Em Teste (14)
Transição (15)
Em Serviço (16)
DMTF Reservado (..)
Fornecedor Reservado (0x8000.. )

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 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 é sempre 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 esse dispositivo foi ativado 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 status de integridade detalhada e de alto nível do elemento e seus subcomponentes. Um valor Null indica que essa propriedade não está implementada. Essa propriedade é herdada de CIM_ManagedSystemElement.

Desconhecido (0)
OK (1)
Degradado (2)
Erro (3)
DMTF Reservado (..)
Fornecedor Reservado (0x8000.. )

ProtocolDescription

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

Uma cadeia de caracteres que fornece mais informações relacionadas ao protocolo com suporte do controlador. Essa propriedade é herdada de CIM_Controller.

ProtocoloSuportado

Tipo de dados: uint16
Tipo de acesso: Somente leitura

O protocolo usado pelo controlador para acessar dispositivos controlados. Essa propriedade é herdada de CIM_Controller.

Valor	Significado
26	IEEE-488

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 por EnabledState. Essa propriedade é fornecida para comparar os últimos estados solicitados e atuais habilitados ou desabilitados. Essa propriedade é herdada de CIM_EnabledLogicalElement.

Valor	Significado
12	Não Aplicável

Segurança

Tipo de dados: uint16
Tipo de acesso: Somente leitura

A segurança operacional do controlador. Essa propriedade é herdada de CIM_SerialController.

Valor	Significado
3	Nenhum

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.

TimeOfLastReset

Tipo de dados: datetime
Tipo de acesso: Somente leitura

A última vez que o controlador foi ligado. Essa propriedade é herdada de CIM_Controller.

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.

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.

Comentários

O acesso à classe Msvm_SerialController 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_SerialController
CIM_SerialController
Classes de dispositivos seriais

Compartilhar via

Classe Msvm_SerialController

Sintaxe

Membros

Métodos

Propriedades

Comentários

Requisitos

Confira também

Comentários

Recursos adicionais