Partager via


Msvm_SyntheticMouse classe

Représente un périphérique de souris synthétique.

La syntaxe suivante est un code MOF (Managed Object Format) simplifié et inclut toutes les propriétés héritées.

Syntaxe

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

Membres

La classe Msvm_SyntheticMouse a les types de membres suivants :

Méthodes

La classe Msvm_SyntheticMouse a ces méthodes.

Méthode Description
ClickButton Simule un clic sur le bouton de l’appareil spécifié.
EnableDevice Cette méthode n'est pas prise en charge.
GetButtonState Récupère l’état actuel du bouton d’appareil spécifié.
OnlineDevice Cette méthode n'est pas prise en charge.
QuiesceDevice Cette méthode n'est pas prise en charge.
RequestStateChange Demande un changement d’état
Réinitialiser Réinitialise l’appareil.
RestoreProperties Cette méthode n'est pas prise en charge.
SaveProperties Cette méthode n'est pas prise en charge.
SetAbsolutePosition Définit la position horizontale et verticale du curseur de la souris.
SetButtonState Définit l’état actuel du bouton d’appareil spécifié.
SetPowerState Cette méthode n'est pas prise en charge.
SetScrollPosition Définit la coordonnée z du contrôle de roue du dispositif de pointage.

Propriétés

La classe Msvm_SyntheticMouse a ces propriétés.

AbsoluteCoordinates

Type de données : booléen

Type d'accès : Lecture seule

Indique si l’appareil fonctionne sur des coordonnées absolues ou relatives.

Valeur Signification
True
Les coordonnées de l’appareil sont absolues.
False
Les coordonnées de l’appareil sont relatives.

AdditionalAvailability

Type de données : tableau uint16

Type d'accès : Lecture seule

Toute disponibilité et status supplémentaires de l’appareil, au-delà de celle spécifiée dans la propriété Availability. La propriété Availability indique le status principal et la disponibilité de l’appareil. Cette propriété est héritée de CIM_LogicalDevice.

Valeur Signification
{6}
Non applicable

Disponibilité

Type de données : uint16

Type d'accès : Lecture seule

Disponibilité principale et status de l’appareil. Cette propriété est héritée de CIM_LogicalDevice.

Valeur Signification
6
Non applicable

AvailableRequestedStates

Type de données : tableau uint16

Type d'accès : Lecture seule

Indique les valeurs possibles pour le paramètre RequestedState de la méthode RequestStateChange . Cette propriété est héritée de CIM_EnabledLogicalElement et est toujours définie sur Null.

Caption

Type de données : chaîne

Type d'accès : Lecture seule

Brève description de l’objet. Cette propriété est héritée de CIM_ManagedElement.

CommunicationStatus

Type de données : uint16

Type d'accès : Lecture seule

Indique la capacité de l’instrumentation à communiquer avec l’élément managé sous-jacent. Une valeur Null indique que cette propriété n’est pas implémentée. Cette propriété est héritée de CIM_ManagedSystemElement.

Inconnu (0)

Non disponible (1)

Communication OK (2)

Perte de communication (3)

Aucun contact (4)

DMTF Reserved (..)

Fournisseur réservé (0x8000.. )

CreationClassName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (256)

Nom de la classe ou de la sous-classe utilisée dans la création d’un instance. Lorsqu’elle est utilisée avec d’autres propriétés de clé de la classe, cette propriété permet à toutes les instances de la classe et à ses sous-classes d’être identifiées de manière unique. Cette propriété est héritée de CIM_LogicalDevice.

Description

Type de données : chaîne

Type d'accès : Lecture seule

Description de l'objet . Cette propriété est héritée de CIM_ManagedElement.

DetailedStatus

Type de données : uint16

Type d'accès : Lecture seule

Complète la propriété PrimaryStatus avec des détails status supplémentaires. Une valeur Null indique que cette propriété n’est pas implémentée. Cette propriété est héritée de CIM_ManagedSystemElement.

Non disponible (0)

Aucune information supplémentaire (1)

Stressé (2)

Échec prédictif (3)

Erreur non récupérable (4)

Entité de prise en charge en erreur (5)

DMTF Reserved (..)

Fournisseur réservé (0x8000.. )

DeviceID

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (64)

Adresse ou autres informations d’identification permettant de nommer de manière unique l’appareil logique. Cette propriété est héritée de CIM_LogicalDevice et est toujours définie sur « Microsoft:GUID ».

ElementName

Type de données : chaîne

Type d'accès : Lecture seule

Nom complet de l’objet. Cette propriété permet à chaque instance de définir un nom d’affichage en plus de ses propriétés de clé, de ses données d’identité et de ses informations de description. La propriété Name de la classe CIM_ManagedSystemElement est également définie en tant que nom complet. Mais, il est souvent sous-classé pour être une clé. Il n’est pas raisonnable qu’une même propriété puisse transmettre à la fois l’identité et un nom d’affichage, sans incohérences. Lorsque Name existe et n’est pas une clé (par exemple pour les instances de LogicalDevice), les mêmes informations peuvent être présentes dans les propriétés Name et ElementName . Cette propriété est héritée de CIM_ManagedElement.

EnabledDefault

Type de données : uint16

Type d'accès : Lecture seule

Configuration par défaut ou de démarrage d’un administrateur pour l’objet EnabledState d’un élément. Cette propriété est héritée de CIM_EnabledLogicalElement.

EnabledState

Type de données : uint16

Type d'accès : Lecture seule

États activés et désactivés d’un élément. Cette propriété est héritée de CIM_EnabledLogicalElement.

Valeur Signification
Activé
2
La machine virtuelle invitée prend en charge une souris synthétique.
Désactivé
3
La machine virtuelle invitée ne prend pas en charge une souris synthétique.

ErrorCleared

Type de données : booléen

Type d'accès : Lecture seule

Indique si l’erreur signalée dans LastErrorCode est maintenant effacée. Cette propriété est héritée de CIM_LogicalDevice, mais elle n’est pas utilisée.

ErrorDescription

Type de données : chaîne

Type d'accès : Lecture seule

Chaîne qui fournit plus d’informations sur l’erreur enregistrée dans LastErrorCode et des informations sur les actions correctives pouvant être effectuées. Cette propriété est héritée de CIM_LogicalDevice, mais elle n’est pas utilisée.

La main

Type de données : uint16

Type d'accès : Lecture seule

Configuration de l’appareil de pointage pour l’opération de droite ou de gauche. Cette propriété est héritée de CIM_PointingDevice.

Valeur Signification
0
Unknown
1
Non applicable.
2
Opération droitier.
3
Opération du gaucher.

HealthState

Type de données : uint16

Type d'accès : Lecture seule

Intégrité actuelle de l’élément. Cette propriété est héritée de CIM_ManagedSystemElement.

Horizontalposition

Type de données : sint32

Type d'accès : Lecture seule

Coordonnée x absolue de l’appareil de pointage.

IdentifyingDescriptions

Type de données : tableau de chaînes

Type d'accès : Lecture seule

Tableau de chaînes de forme libre qui fournissent des explications et des détails derrière les entrées dans le tableau OtherIdentifyingInfo . Cette propriété est héritée de CIM_LogicalDevice.

InstallDate

Type de données : datetime

Type d'accès : Lecture seule

Date et heure de création de la machine virtuelle. Cette propriété est héritée de CIM_ManagedSystemElement.

InstanceID

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : Clé

Identifie de manière unique un instance de cette classe. Cette propriété est héritée de CIM_ManagedElement.

IsLocked

Type de données : booléen

Type d'accès : Lecture seule

Indique si l’appareil est verrouillé, empêchant l’entrée ou la sortie de l’utilisateur. Cette propriété est héritée de CIM_UserDevice.

LastErrorCode

Type de données : uint32

Type d'accès : Lecture seule

Dernier code d’erreur signalé par l’appareil logique. Cette propriété est héritée de CIM_LogicalDevice, mais elle n’est pas utilisée.

MaxQuiesceTime

Type de données : uint64

Type d'accès : Lecture seule

Cette propriété est dépréciée. Cette propriété est héritée de CIM_LogicalDevice.

Nom

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (1024)

Étiquette par laquelle l’objet est connu. En cas de sous-classe, cette propriété peut être remplacée pour être une propriété de clé. Cette propriété est héritée de CIM_ManagedSystemElement.

NumberOfButtons

Type de données : uint8

Type d'accès : Lecture seule

Nombre de boutons sur l’appareil de pointage. Cette propriété est héritée de CIM_PointingDevice.

OperatingStatus

Type de données : uint16

Type d'accès : Lecture seule

Fournit des informations de status actuelles sur la condition opérationnelle de l’élément et peut être utilisée pour fournir plus de détails concernant la valeur de la propriété EnabledState. Une valeur Null indique que cette propriété n’est pas implémentée. Cette propriété est héritée de CIM_ManagedSystemElement.

Inconnu (0)

Non disponible (1)

Maintenance (2)

Démarrage (3)

Arrêt (4)

Arrêté (5)

Abandonné (6)

Dormant (7)

Terminé (8)

Migration (9)

Emigrating (10)

Immigration (11)

Capture instantanée (12)

Arrêt ( 13)

En test (14)

Transition ( 15)

En service (16)

DMTF Reserved (..)

Fournisseur réservé (0x8000.. )

OperationalStatus

Type de données : tableau uint16

Type d'accès : Lecture seule

Status actuelle de l’élément. Cette propriété est héritée de CIM_ManagedSystemElement.

OtherEnabledState

Type de données : chaîne

Type d'accès : Lecture seule

État activé ou désactivé de l’élément lorsque la propriété EnabledState a la valeur 1 (Autre). Cette propriété doit avoir la valeur Null lorsque EnabledState a une valeur autre que 1. Cette propriété est héritée de CIM_EnabledLogicalElement.

OtherIdentifyingInfo

Type de données : tableau de chaînes

Type d'accès : Lecture seule

Toutes les données supplémentaires, au-delà des informations d’ID d’appareil, qui peuvent être utilisées pour identifier un appareil logique. Cette propriété est héritée de CIM_LogicalDevice.

PointingType

Type de données : uint16

Type d'accès : Lecture seule

Type d’appareil de pointage. Cette propriété est héritée de CIM_PointingDevice.

Valeur Signification
3
Souris

PowerManagementCapabilities

Type de données : tableau uint16

Type d'accès : Lecture seule

Fonctionnalités de gestion de l’alimentation de l’appareil. Cette propriété est héritée de CIM_LogicalDevice, mais elle n’est pas utilisée.

PowerManagementSupported

Type de données : booléen

Type d'accès : Lecture seule

Indique si l’appareil peut être géré par l’alimentation. Cette propriété est héritée de CIM_LogicalDevice, mais elle n’est pas utilisée.

PowerOnHours

Type de données : uint64

Type d'accès : Lecture seule

Nombre d’heures consécutives pendant lesquelles cet appareil a été mis sous tension depuis son dernier cycle d’alimentation. Cette propriété est héritée de CIM_LogicalDevice, mais elle n’est pas utilisée.

PrimaryStatus

Type de données : uint16

Type d'accès : Lecture seule

Fournit des informations de status de haut niveau. Cette propriété doit être utilisée conjointement avec la propriété DetailedStatus pour fournir un status d’intégrité de haut niveau et détaillé de l’élément et de ses sous-composants. Une valeur Null indique que cette propriété n’est pas implémentée. Cette propriété est héritée de CIM_ManagedSystemElement.

Inconnu (0)

OK (1)

Détérioré (2)

Erreur (3)

DMTF Reserved (..)

Fournisseur réservé (0x8000.. )

RequestedState

Type de données : uint16

Type d'accès : Lecture seule

Dernier état demandé ou souhaité pour l’élément. Cette propriété est héritée de CIM_EnabledLogicalElement.

Valeur Signification
12
Non applicable

Résolution :

Type de données : uint32

Type d'accès : Lecture seule

Résolution de suivi de l’appareil de pointage, en nombres par pouce. Cette propriété est héritée de CIM_PointingDevice.

ScrollPosition

Type de données : sint32

Type d'accès : Lecture seule

Qualificateurs : Unités (« Mickeys »)

Position de coordonnée z de l’appareil souris.

État

Type de données : chaîne

Type d'accès : Lecture seule

Status actuelle de l’objet. Cette propriété est héritée de CIM_ManagedSystemElement, mais elle n’est pas utilisée.

StatusDescriptions

Type de données : tableau de chaînes

Type d'accès : Lecture seule

Chaînes qui décrivent les différentes valeurs du tableau OperationalStatus . Cette propriété est héritée de CIM_ManagedSystemElement.

StatusInfo

Type de données : uint16

Type d'accès : Lecture seule

État actuel de l’appareil logique. Cette propriété est héritée de CIM_LogicalDevice, mais elle n’est pas utilisée.

SystemCreationClassName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (256)

Nom de la classe de création du système d’étendue. Cette propriété est héritée de CIM_LogicalDevice.

SystemName

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (256)

Nom du système d’étendue. Cette valeur correspond à la valeur de la propriété Name de la classe Msvm_ComputerSystem pour l’étendue de la machine virtuelle. Cette propriété est héritée de CIM_LogicalDevice.

TimeOfLastStateChange

Type de données : datetime

Type d'accès : Lecture seule

Date ou heure de la dernière modification de l’état activé de l’élément. Si l’état de l’élément n’a pas changé et que cette propriété est remplie, elle doit être définie sur une valeur d’intervalle 0. Si une modification d’état a été demandée, mais rejetée ou pas encore traitée, la propriété ne doit pas être mise à jour. Cette propriété est héritée de CIM_EnabledLogicalElement et est toujours définie sur Null.

TotalPowerOnHours

Type de données : uint64

Type d'accès : Lecture seule

Nombre total d’heures pendant lesquelles cet appareil a été alimenté. Cette propriété est héritée de CIM_LogicalDevice, mais elle n’est pas utilisée.

TransitioningToState

Type de données : uint16

Type d'accès : Lecture seule

Indique l’état cible vers lequel le instance effectue la transition. Cette propriété est héritée de CIM_EnabledLogicalElement et est toujours définie sur Null.

Verticalposition

Type de données : sint32

Type d'accès : Lecture seule

Coordonnée y absolue de l’appareil de pointage.

Notes

L’accès à la classe Msvm_SyntheticMouse peut être limité par le filtrage UAC. Pour plus d’informations, consultez Contrôle de compte d’utilisateur et WMI.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server 2012 [applications de bureau uniquement]
Espace de noms
Root\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Voir aussi

CIM_PointingDevice

CIM_PointingDevice

Classes d’entrée