класс Msvm_SyntheticMouse

Статья
06/13/2023

Представляет устройство искусственной мыши.

Следующий синтаксис представляет собой упрощенный код формата управляемого объекта (MOF) и включает все унаследованные свойства.

Синтаксис

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

Члены

Класс Msvm_SyntheticMouse имеет следующие типы членов:

Методы
Свойства

Методы

Класс Msvm_SyntheticMouse содержит следующие методы.

Метод	Описание
ClickButton	Имитирует нажатие кнопки указанного устройства.
EnableDevice	Этот метод не поддерживается.
GetButtonState	Извлекает текущее состояние указанной кнопки устройства.
OnlineDevice	Этот метод не поддерживается.
QuiesceDevice	Этот метод не поддерживается.
RequestStateChange	Запрашивает изменение состояния
Reset	Сбрасывает устройство.
RestoreProperties	Этот метод не поддерживается.
Saveproperties	Этот метод не поддерживается.
SetAbsolutePosition	Задает горизонтальное и вертикальное положение курсора мыши.
SetButtonState	Задает текущее состояние указанной кнопки устройства.
SetPowerState	Этот метод не поддерживается.
SetScrollPosition	Задает Z-координату элемента управления колесом указывающего устройства.

Свойства

Класс Msvm_SyntheticMouse имеет следующие свойства.

AbsoluteCoordinates

Тип данных: boolean
Тип доступа: только для чтения

Указывает, работает ли устройство с абсолютными или относительными координатами.

Значение	Значение
True	Координаты устройства являются абсолютными.
False	Координаты устройства являются относительными.

AdditionalAvailability

Тип данных: массив uint16
Тип доступа: только для чтения

Любые дополнительные сведения о доступности и состоянии устройства, кроме указанного в свойстве Availability . Свойство Availability обозначает основное состояние и доступность устройства. Это свойство наследуется от CIM_LogicalDevice.

Значение	Значение
{6}	Неприменимо

Доступность

Тип данных: uint16
Тип доступа: только для чтения

Основная доступность и состояние устройства. Это свойство наследуется от CIM_LogicalDevice.

Значение	Значение
6	Неприменимо

AvailableRequestedStates

Тип данных: массив uint16
Тип доступа: только для чтения

Указывает возможные значения для параметра RequestedState метода RequestStateChange . Это свойство наследуется от CIM_EnabledLogicalElement и всегда имеет значение Null.

Caption

Тип данных: string
Тип доступа: только для чтения

Краткое описание объекта. Это свойство наследуется от CIM_ManagedElement.

CommunicationStatus

Тип данных: uint16
Тип доступа: только для чтения

Указывает на способность инструментирования взаимодействовать с базовым управляемым элементом. Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

Неизвестно (0)
Недоступно (1)
Связь ОК (2)
Потерянная связь (3)
Нет контакта (4)
DmTF Reserved (..)
Зарезервировано поставщиком (0x8000.. )

CreationClassName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (256)

Имя класса или подкласса, используемого при создании экземпляра. При использовании с другими ключевыми свойствами класса это свойство позволяет уникально идентифицировать все экземпляры класса и его подклассы. Это свойство наследуется от CIM_LogicalDevice.

Описание

Тип данных: string
Тип доступа: только для чтения

Описание объекта. Это свойство наследуется от CIM_ManagedElement.

DetailedStatus

Тип данных: uint16
Тип доступа: только для чтения

Дополняет свойство PrimaryStatus дополнительными сведениями о состоянии. Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

Недоступно (0)
Нет дополнительной информации (1)
Подчеркнуто (2)
Прогнозный сбой (3)
Невосстанавливаемая ошибка (4)
Ошибка поддержки сущности (5)
Зарезервировано DMTF (..)
Зарезервировано поставщиком (0x8000.. )

DeviceID

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (64)

Адрес или другие идентифицирующие сведения для уникального имени логического устройства. Это свойство наследуется от CIM_LogicalDevice и всегда имеет значение Microsoft:GUID.

ElementName

Тип данных: string
Тип доступа: только для чтения

Отображаемое имя объекта. Это свойство позволяет каждому экземпляру определять отображаемое имя в дополнение к свойствам ключа, данным идентификации и сведениям об описании. Свойство Name класса CIM_ManagedSystemElement также определяется как отображаемое имя. Но его часто подразделяют как ключ. Недопустимо, чтобы одно и то же свойство может передавать как идентификатор, так и отображаемое имя без несоответствий. Если имя существует и не является ключом (например, для экземпляров LogicalDevice), одинаковые сведения могут присутствовать в свойствах Name и ElementName . Это свойство наследуется от CIM_ManagedElement.

EnabledDefault

Тип данных: uint16
Тип доступа: только для чтения

Конфигурация по умолчанию или запуска администратора для EnabledState элемента. Это свойство наследуется от CIM_EnabledLogicalElement.

EnabledState

Тип данных: uint16
Тип доступа: только для чтения

Включенные и отключенные состояния элемента. Это свойство наследуется от CIM_EnabledLogicalElement.

Значение	Значение
Enabled 2	Гостевая виртуальная машина поддерживает искусственную мышь.
Отключено 3	Гостевая виртуальная машина не поддерживает искусственную мышь.

ErrorCleared

Тип данных: boolean
Тип доступа: только для чтения

Указывает, снята ли ошибка, сообщаемая в LastErrorCode . Это свойство наследуется от CIM_LogicalDevice, но не используется.

ErrorDescription

Тип данных: string
Тип доступа: только для чтения

Строка, которая предоставляет дополнительные сведения об ошибке, записанной в LastErrorCode , и сведения о любых корректирующих действиях, которые можно выполнить. Это свойство наследуется от CIM_LogicalDevice, но не используется.

Handedness

Тип данных: uint16
Тип доступа: только для чтения

Конфигурация указывающего устройства для правой или левой операции. Это свойство наследуется от CIM_PointingDevice.

Значение	Значение
0	Неизвестно
1	Не применяется
2	Операция правой рукой.
3	Операция с левой рукой.

HealthState

Тип данных: uint16
Тип доступа: только для чтения

Текущая работоспособность элемента. Это свойство наследуется от CIM_ManagedSystemElement.

Горизонтальное положение

Тип данных: sint32
Тип доступа: только для чтения

Абсолютная координата X указывающего устройства.

IdentifyingDescriptions

Тип данных: строковый массив
Тип доступа: только для чтения

Массив строк свободной формы, которые предоставляют объяснения и сведения о записях в массиве OtherIdentifyingInfo . Это свойство наследуется от CIM_LogicalDevice.

InstallDate

Тип данных: datetime
Тип доступа: только для чтения

Дата и время создания виртуальной машины. Это свойство наследуется от CIM_ManagedSystemElement.

InstanceID

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: Ключ

Уникально идентифицирует экземпляр этого класса. Это свойство наследуется от CIM_ManagedElement.

IsLocked

Тип данных: boolean
Тип доступа: только для чтения

Указывает, заблокировано ли устройство, препятствуя вводу или выводу данных пользователем. Это свойство наследуется от CIM_UserDevice.

LastErrorCode

Тип данных: uint32
Тип доступа: только для чтения

Последний код ошибки, сообщаемый логическим устройством. Это свойство наследуется от CIM_LogicalDevice, но не используется.

MaxQuiesceTime

Тип данных: uint64
Тип доступа: только для чтения

Это свойство использовать не рекомендуется. Это свойство наследуется от CIM_LogicalDevice.

имя;

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (1024)

Метка, по которой известен объект. При подклассе это свойство может быть переопределено как ключевое свойство. Это свойство наследуется от CIM_ManagedSystemElement.

NumberOfButtons

Тип данных: uint8
Тип доступа: только для чтения

Количество кнопок на указывающее устройство. Это свойство наследуется от CIM_PointingDevice.

OperatingStatus

Тип данных: uint16
Тип доступа: только для чтения

Предоставляет сведения о текущем состоянии для рабочего состояния элемента и может использоваться для предоставления дополнительных сведений о значении свойства EnabledState . Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

Неизвестно (0)
Недоступно (1)
Обслуживание (2)
Начиная ( 3)
Остановка (4)
Остановлено (5)
Прервано (6)
Неактивный (7)
Завершено (8)
Миграция (9)
Эмигрирование (10)
Иммигрирование (11)
Создание моментальных снимков (12)
Завершение работы (13)
В тесте (14)
Переход ( 15)
В службе (16)
Зарезервировано DMTF (..)
Зарезервировано поставщиком (0x8000.. )

OperationalStatus

Тип данных: массив uint16
Тип доступа: только для чтения

Текущее состояние элемента. Это свойство наследуется от CIM_ManagedSystemElement.

OtherEnabledState

Тип данных: string
Тип доступа: только для чтения

Состояние "Включено" или "Отключено" элемента, когда свойству EnabledState присвоено значение 1 (Other). Это свойство должно иметь значение Null , если EnabledState имеет любое значение, отличное от 1. Это свойство наследуется от CIM_EnabledLogicalElement.

OtherIdentifyingInfo

Тип данных: строковый массив
Тип доступа: только для чтения

Любые дополнительные данные, помимо сведений об идентификаторе устройства, которые можно использовать для идентификации логического устройства. Это свойство наследуется от CIM_LogicalDevice.

PointingType

Тип данных: uint16
Тип доступа: только для чтения

Тип указывающего устройства. Это свойство наследуется от CIM_PointingDevice.

Значение	Значение
3	Мышь

PowerManagementCapabilities

Тип данных: массив uint16
Тип доступа: только для чтения

Возможности управления питанием устройства. Это свойство наследуется от CIM_LogicalDevice, но не используется.

PowerManagementSupported

Тип данных: boolean
Тип доступа: только для чтения

Указывает, можно ли управлять питанием устройства. Это свойство наследуется от CIM_LogicalDevice, но не используется.

PowerOnHours

Тип данных: uint64
Тип доступа: только для чтения

Количество последовательных часов, в течение которых это устройство включается с момента последнего цикла питания. Это свойство наследуется от CIM_LogicalDevice, но не используется.

PrimaryStatus

Тип данных: uint16
Тип доступа: только для чтения

Предоставляет сведения о состоянии высокого уровня. Это свойство следует использовать вместе со свойством DetailedStatus , чтобы обеспечить высокий уровень и подробное состояние работоспособности элемента и его подкомпонентов. Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

Неизвестно (0)
ОК (1)
Понижение производительности (2)
Ошибка (3)
Зарезервировано DMTF (..)
Зарезервировано поставщиком (0x8000.. )

RequestedState

Тип данных: uint16
Тип доступа: только для чтения

Последнее запрошенное или требуемое состояние элемента. Это свойство наследуется от CIM_EnabledLogicalElement.

Значение	Значение
12	Неприменимо

Решение

Тип данных: uint32
Тип доступа: только для чтения

Разрешение отслеживания указывающего устройства в количестве на дюйм. Это свойство наследуется от CIM_PointingDevice.

ScrollPosition

Тип данных: sint32
Тип доступа: только для чтения
Квалификаторы: Единицы ("Микки")

Z-координата устройства мыши.

Состояние

Тип данных: string
Тип доступа: только для чтения

Текущее состояние объекта. Это свойство наследуется от CIM_ManagedSystemElement, но не используется.

Описания состояния

Тип данных: строковый массив
Тип доступа: только для чтения

Строки, описывающие различные значения массива OperationalStatus . Это свойство наследуется от CIM_ManagedSystemElement.

StatusInfo

Тип данных: uint16
Тип доступа: только для чтения

Текущее состояние логического устройства. Это свойство наследуется от CIM_LogicalDevice, но не используется.

SystemCreationClassName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (256)

Имя класса создания системы определения области. Это свойство наследуется от CIM_LogicalDevice.

SystemName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen (256)

Имя системы определения области. Это значение соответствует значению свойства Name класса Msvm_ComputerSystem для области виртуальной машины. Это свойство наследуется от CIM_LogicalDevice.

TimeOfLastStateChange

Тип данных: datetime
Тип доступа: только для чтения

Дата или время последнего изменения состояния включенного элемента. Если состояние элемента не изменилось и это свойство заполнено, ему необходимо задать значение интервала 0. Если изменение состояния было запрошено, но отклонено или еще не обработано, свойство не должно обновляться. Это свойство наследуется от CIM_EnabledLogicalElement и всегда имеет значение Null.

TotalPowerOnHours

Тип данных: uint64
Тип доступа: только для чтения

Общее количество часов питания этого устройства. Это свойство наследуется от CIM_LogicalDevice, но не используется.

TransitioningToState

Тип данных: uint16
Тип доступа: только для чтения

Указывает целевое состояние, в которое переходит экземпляр. Это свойство наследуется от CIM_EnabledLogicalElement и всегда имеет значение Null.

Вертикальное положение

Тип данных: sint32
Тип доступа: только для чтения

Абсолютная координата Y указывающего устройства.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 [только классические приложения]
Пространство имен	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

См. также раздел

CIM_PointingDevice
CIM_PointingDevice
Входные классы

Поделиться через