Msvm_SyntheticMouse clase

Artículo
06/13/2023

Representa un dispositivo de mouse sintético.

La sintaxis siguiente es código de Formato de objeto administrado (MOF) simplificado e incluye todas las propiedades heredadas.

Sintaxis

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

Miembros

La clase Msvm_SyntheticMouse tiene estos tipos de miembros:

Métodos
Propiedades

Métodos

La clase Msvm_SyntheticMouse tiene estos métodos.

Método	Descripción
ClickButton	Simula un clic de botón del botón especificado del dispositivo.
EnableDevice	No se admite este método.
GetButtonState	Recupera el estado actual del botón de dispositivo especificado.
OnlineDevice	No se admite este método.
QuiesceDevice	No se admite este método.
RequestStateChange	Solicita un cambio de estado
Restablecer	Restablece el dispositivo.
RestoreProperties	No se admite este método.
SaveProperties	No se admite este método.
SetAbsolutePosition	Establece la posición horizontal y vertical del cursor del mouse.
SetButtonState	Establece el estado actual del botón de dispositivo especificado.
SetPowerState	No se admite este método.
SetScrollPosition	Establece la coordenada z del control de rueda del dispositivo que señala.

Propiedades

La clase Msvm_SyntheticMouse tiene estas propiedades.

AbsoluteCoordinates

Tipo de datos: booleano
Tipo de acceso: solo lectura

Indica si el dispositivo funciona en coordenadas absolutas o relativas.

Valor	Significado
True	Las coordenadas del dispositivo son absolutas.
False	Las coordenadas del dispositivo son relativas.

AdditionalAvailability

Tipo de datos: matriz uint16
Tipo de acceso: solo lectura

Cualquier disponibilidad y estado adicionales del dispositivo, más allá de lo especificado en la propiedad Availability . La propiedad Availability indica el estado principal y la disponibilidad del dispositivo. Esta propiedad se hereda de CIM_LogicalDevice.

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

Valor	Significado
6	No es 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 . Esta propiedad se hereda de CIM_EnabledLogicalElement y siempre se establece en Null.

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.

Desconocido (0)
No disponible (1)
Comunicación correcta (2)
Comunicación perdida (3)
Sin contacto (4)
DMTF Reserved (..)
Proveedor reservado (0x8000.. )

CreationClassName

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MaxLen (256)

Nombre de la clase o subclase usada en la creación de una instancia. Cuando se usa con otras propiedades clave de la clase , esta propiedad permite identificar todas las instancias de la clase y sus subclases. Esta propiedad se hereda de CIM_LogicalDevice.

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.

No disponible (0)
Sin información adicional (1)
Estresado (2)
Error predictivo (3)
Error no recuperable (4)
Entidad auxiliar en error (5)
DMTF Reserved (..)
Proveedor reservado (0x8000.. )

Deviceid

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MaxLen (64)

Una dirección u otra información de identificación para asignar un nombre único al dispositivo lógico. Esta propiedad se hereda de CIM_LogicalDevice y siempre se establece en "Microsoft:GUID".

ElementName

Tipo de datos: cadena
Tipo de acceso: solo lectura

Nombre para mostrar del objeto. Esta propiedad permite a cada instancia definir un nombre para mostrar además de sus propiedades clave, datos de identidad e información de descripción. La propiedad Name de la clase CIM_ManagedSystemElement también se define como un nombre para mostrar. Sin embargo, a menudo se subclase como clave. No es razonable que la misma propiedad pueda transmitir tanto la identidad como un nombre para mostrar, sin incoherencias. Cuando Name existe y no es una clave (por ejemplo, para instancias de LogicalDevice), la misma información puede estar presente en las propiedades Name y ElementName . Esta propiedad se hereda de CIM_ManagedElement.

EnabledDefault

Tipo de datos: uint16
Tipo de acceso: solo lectura

Configuración predeterminada o de inicio de un administrador para EnabledState 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. Esta propiedad se hereda de CIM_EnabledLogicalElement.

Valor	Significado
Enabled 2	La máquina virtual invitada admite un mouse sintético.
Deshabilitada 3	La máquina virtual invitada no admite un mouse sintético.

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.

Imparcialidad

Tipo de datos: uint16
Tipo de acceso: solo lectura

Configuración del dispositivo que apunta a la operación de mano derecha o izquierda. Esta propiedad se hereda de CIM_PointingDevice.

Valor	Significado
0	Unknown
1	No aplicable.
2	Operación de mano derecha.
3	Operación de mano izquierda.

HealthState

Tipo de datos: uint16
Tipo de acceso: solo lectura

Estado actual del elemento. Esta propiedad se hereda de CIM_ManagedSystemElement.

Horizontalposition

Tipo de datos: sint32
Tipo de acceso: solo lectura

Coordenada x absoluta del dispositivo que señala.

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 OtherIdentifyingInfo . Esta propiedad se hereda de CIM_LogicalDevice.

InstallDate

Tipo de datos: datetime
Tipo de acceso: solo lectura

Fecha y hora en que se creó 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.

IsLocked

Tipo de datos: booleano
Tipo de acceso: solo lectura

Indica si el dispositivo está bloqueado, lo que impide la entrada o salida del usuario. Esta propiedad se hereda de CIM_UserDevice.

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.

MaxQuiesceTime

Tipo de datos: uint64
Tipo de acceso: solo lectura

Esta propiedad está en desuso. Esta propiedad se hereda de CIM_LogicalDevice.

Nombre

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MaxLen (1024)

Etiqueta por la que se conoce el objeto. Cuando se subclase, esta propiedad se puede invalidar para que sea una propiedad de clave. Esta propiedad se hereda de CIM_ManagedSystemElement.

NumberOfButtons

Tipo de datos: uint8
Tipo de acceso: solo lectura

Número de botones del dispositivo que señala. Esta propiedad se hereda de CIM_PointingDevice.

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.

Desconocido (0)
No disponible (1)
Mantenimiento (2)
A partir de (3)
Detener (4)
Detenido (5)
Anulado (6)
Inactivo (7)
Completado (8)
Migración (9)
Emigración (10)
Migración (11)
Instantáneas (12)
Apagar (13)
En prueba (14)
Transición (15)
En servicio (16)
DMTF Reserved (..)
Proveedor reservado (0x8000.. )

OperationalStatus

Tipo de datos: matriz uint16
Tipo de acceso: solo lectura

Estado actual del elemento. 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 (Otro). Esta propiedad debe establecerse en Null cuando 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.

PointingType

Tipo de datos: uint16
Tipo de acceso: solo lectura

Tipo de dispositivo que apunta. Esta propiedad se hereda de CIM_PointingDevice.

Valor	Significado
3	Mouse

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 un estado de mantenimiento alto y detallado del elemento y sus subcomponentes. Un valor Null indica que esta propiedad no está implementada. Esta propiedad se hereda de CIM_ManagedSystemElement.

Desconocido (0)
Correcto (1)
Degradado (2)
Error (3)
DMTF Reserved (..)
Vendor Reserved (0x8000.. )

RequestedState

Tipo de datos: uint16
Tipo de acceso: solo lectura

El último estado solicitado o deseado para el elemento. Esta propiedad se hereda de CIM_EnabledLogicalElement.

Valor	Significado
12	No es aplicable

Resolución

Tipo de datos: uint32
Tipo de acceso: solo lectura

Resolución de seguimiento del dispositivo señalador, en recuentos por pulgada. Esta propiedad se hereda de CIM_PointingDevice.

ScrollPosition

Tipo de datos: sint32
Tipo de acceso: solo lectura
Calificadores: Unidades ("Mickeys")

Posición de coordenada z del dispositivo del mouse.

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
Calificadores: MaxLen (256)

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
Calificadores: MaxLen (256)

Nombre del sistema de ámbito. Este valor corresponde al valor de la propiedad Name de la clase Msvm_ComputerSystem para la máquina virtual de ámbito. Esta propiedad se hereda de CIM_LogicalDevice.

TimeOfLastStateChange

Tipo de datos: datetime
Tipo de acceso: solo lectura

Fecha u hora en que el estado habilitado del elemento cambió por última vez. Si el estado del elemento no ha cambiado y esta propiedad se rellena, debe establecerse en un valor de intervalo 0. Si se solicitó un cambio de estado, pero se rechazó o aún no se procesó, la propiedad no se debe actualizar. Esta propiedad se hereda de CIM_EnabledLogicalElement y siempre se establece en Null.

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 y siempre se establece en Null.

VerticalPosition

Tipo de datos: sint32
Tipo de acceso: solo lectura

Coordenada Y absoluta del dispositivo señalador.

Comentarios

El acceso a la clase Msvm_SyntheticMouse podría estar restringido por el filtrado de UAC. Para obtener más información, vea 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	WindowsVirtualization.V2.mof
Archivo DLL	Vmms.exe

Consulte también

CIM_PointingDevice
CIM_PointingDevice
Clases de entrada

Compartir a través de

Msvm_SyntheticMouse clase

Sintaxis

Miembros

Métodos

Propiedades

Comentarios

Requisitos

Consulte también

Comentarios

Recursos adicionales