Compartilhar via


classe Msvm_SyntheticMouse

Representa um dispositivo de mouse sintético.

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

Sintaxe

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_SyntheticMouse : CIM_PointingDevice
{
  string   InstanceID;
  string   Caption = "Mouse";
  string   Description = "Microsoft Synthetic Mouse";
  string   ElementName = "Mouse";
  datetime InstallDate;
  string   Name = "Mouse";
  uint16   OperationalStatus[] = { 2 };
  string   StatusDescriptions[] = {
                "OK"
              };
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 2;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  string   CreationClassName = "Msvm_SyntheticMouse";
  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;
  boolean  IsLocked = False;
  uint16   PointingType = 3;
  uint8    NumberOfButtons = 5;
  uint16   Handedness = 2;
  uint32   Resolution;
  boolean  AbsoluteCoordinates = True;
  sint32   HorizontalPosition;
  sint32   VerticalPosition;
  sint32   ScrollPosition;
};

Membros

A classe Msvm_SyntheticMouse tem estes tipos de membros:

Métodos

A classe Msvm_SyntheticMouse tem esses métodos.

Método Descrição
ClickButton Simula um clique de botão do botão de dispositivo especificado.
EnableDevice Não há suporte para o método.
GetButtonState Recupera o estado atual do botão de dispositivo especificado.
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.
Setabsoluteposition Define a posição horizontal e vertical do cursor do mouse.
SetButtonState Define o estado atual do botão de dispositivo especificado.
SetPowerState Não há suporte para o método.
SetScrollPosition Define a coordenada z do controle de roda do dispositivo apontador.

Propriedades

A classe Msvm_SyntheticMouse tem essas propriedades.

AbsoluteCoordinates

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Indica se o dispositivo opera em coordenadas absolutas ou relativas.

Valor Significado
Verdadeiro
As coordenadas do dispositivo são absolutas.
Falso
As coordenadas do dispositivo são relativas.

AdditionalAvailability

Tipo de dados: matriz uint16

Tipo de acesso: Somente leitura

Qualquer disponibilidade adicional e status do dispositivo, além do especificado na propriedade Availability. A propriedade Availability indica o status primário e a disponibilidade do dispositivo. Essa propriedade é herdada de CIM_LogicalDevice.

Valor Significado
{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 e é sempre definida como Null.

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

Qualificadores: MaxLen (256)

O nome da classe ou subclasse usada na criação de uma instância. Quando usada com outras propriedades de chave da classe , essa propriedade permite que todas as instâncias da classe e suas subclasses sejam identificadas exclusivamente. 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 status adicionais. 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

Qualificadores: MaxLen (64)

Um endereço ou outras informações de identificação para nomear exclusivamente o dispositivo lógico. 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 permite que cada instância defina um nome de exibição além de suas principais propriedades, dados de identidade e informações de descrição. A propriedade Name da classe CIM_ManagedSystemElement também é definida como um nome de exibição. Mas, muitas vezes, é subclasse para ser uma Chave. Não é razoável que a mesma propriedade possa transmitir uma identidade e um nome de exibição, sem inconsistências. Onde Name existe e não é uma Chave (como para instâncias de LogicalDevice), as mesmas informações podem estar presentes nas propriedades Name e ElementName . 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 EnabledState 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. Essa propriedade é herdada de CIM_EnabledLogicalElement.

Valor Significado
Enabled
2
A máquina virtual convidada dá suporte a um mouse sintético.
Desabilitado
3
A máquina virtual convidada não dá suporte a um mouse sintético.

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.

Handedness

Tipo de dados: uint16

Tipo de acesso: Somente leitura

A configuração do dispositivo apontador para operação à direita ou à esquerda. Essa propriedade é herdada de CIM_PointingDevice.

Valor Significado
0
Unknown
1
Não aplicável.
2
Operação de direita.
3
Operação canhota.

HealthState

Tipo de dados: uint16

Tipo de acesso: Somente leitura

A integridade atual do elemento. Essa propriedade é herdada de CIM_ManagedSystemElement.

HorizontalPosition

Tipo de dados: sint32

Tipo de acesso: Somente leitura

A coordenada x absoluta do dispositivo apontador.

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 OtherIdentifyingInfo . Essa propriedade é herdada de CIM_LogicalDevice.

InstallDate

Tipo de dados: datetime

Tipo de acesso: Somente leitura

A data e a hora em que a 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.

IsLocked

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Indica se o dispositivo está bloqueado, impedindo a entrada ou a saída do usuário. Essa propriedade é herdada de CIM_UserDevice.

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.

MaxQuiesceTime

Tipo de dados: uint64

Tipo de acesso: Somente leitura

Essa propriedade foi substituída. Essa propriedade é herdada de CIM_LogicalDevice.

Nome

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (1024)

O rótulo pelo qual o objeto é conhecido. Quando subclasse, essa propriedade pode ser substituída para ser uma propriedade de chave. Essa propriedade é herdada de CIM_ManagedSystemElement.

NumberOfButtons

Tipo de dados: uint8

Tipo de acesso: Somente leitura

O número de botões no dispositivo apontador. Essa propriedade é herdada de CIM_PointingDevice.

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

O status atual do elemento. 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.

PointingType

Tipo de dados: uint16

Tipo de acesso: Somente leitura

O tipo de dispositivo apontador. Essa propriedade é herdada de CIM_PointingDevice.

Valor Significado
3
Mouse

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

RequestedState

Tipo de dados: uint16

Tipo de acesso: Somente leitura

O último estado solicitado ou desejado para o elemento . Essa propriedade é herdada de CIM_EnabledLogicalElement.

Valor Significado
12
Não Aplicável

Resolução

Tipo de dados: uint32

Tipo de acesso: Somente leitura

A resolução de acompanhamento do dispositivo apontador, em contagens por polegada. Essa propriedade é herdada de CIM_PointingDevice.

ScrollPosition

Tipo de dados: sint32

Tipo de acesso: Somente leitura

Qualificadores: Unidades ("Mickeys")

A posição da coordenada z do dispositivo do mouse.

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

Qualificadores: MaxLen (256)

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

Qualificadores: MaxLen (256)

O nome do sistema de escopo. Esse valor corresponde ao valor da propriedade Name da classe Msvm_ComputerSystem para a máquina virtual de escopo. Essa propriedade é herdada de CIM_LogicalDevice.

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. Se o estado do elemento não tiver sido alterado e essa propriedade for preenchida, ela deverá ser definida como um valor de intervalo de 0. Se uma alteração de estado foi solicitada, mas rejeitada ou ainda não processada, a propriedade não deve ser atualizada. 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 e sempre é definida como Null.

VerticalPosition

Tipo de dados: sint32

Tipo de acesso: Somente leitura

A coordenada y absoluta do dispositivo apontador.

Comentários

O acesso à classe Msvm_SyntheticMouse 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_PointingDevice

CIM_PointingDevice

Classes de entrada