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	状態の変更を要求します
リセット	デバイスをリセットします。
RestoreProperties	このメソッドはサポートされていません。
SaveProperties	このメソッドはサポートされていません。
SetAbsolutePosition	マウスカーソルの水平方向と垂直方向の位置を設定します。
SetButtonState	指定したデバイスボタンの現在の状態を設定します。
SetPowerState	このメソッドはサポートされていません。
SetScrollPosition	ポインティングデバイスのホイールコントロールの z 座標を設定します。

プロパティ

Msvm_SyntheticMouse クラスには、これらのプロパティがあります。

AbsoluteCoordinates

データ型: ブール値
アクセスの種類: 読み取り専用

デバイスが絶対座標と相対座標のどちらを操作するかを示します。

値	説明
True	デバイスの座標は絶対です。
False	デバイスの座標は相対的です。

AdditionalAvailability

データ型: uint16 配列
アクセスの種類: 読み取り専用

デバイスの追加の可用性と状態は、 Availability プロパティで指定された値を超えています。 Availability プロパティは、デバイスのプライマリ状態と可用性を示します。このプロパティは、 CIM_LogicalDeviceから継承されます。

値	説明
{6}	適用しない

可用性

データ型: uint16
アクセスの種類: 読み取り専用

デバイスのプライマリ可用性と状態。このプロパティは、 CIM_LogicalDeviceから継承されます。

値	説明
6	適用しない

AvailableRequestedStates

データ型: uint16 配列
アクセスの種類: 読み取り専用

RequestStateChange メソッドの RequestedState パラメーターに指定できる値を示します。このプロパティは CIM_EnabledLogicalElementから継承され、常に Null に設定 されます。

Caption

データ型: string
アクセスの種類: 読み取り専用

オブジェクトの簡単な説明。このプロパティは、 CIM_ManagedElementから継承されます。

CommunicationStatus

データ型: uint16
アクセスの種類: 読み取り専用

基になるマネージド要素と通信するインストルメンテーションの機能を示します。 Null 値は、このプロパティが実装されていないことを示します。このプロパティは、 CIM_ManagedSystemElementから継承されます。

不明 (0)
使用できません (1)
通信 OK (2)
失われた通信 (3)
連絡先なし (4)
DMTF 予約済み (...)
Vendor 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
アクセスの種類: 読み取り専用

オブジェクトの表示名。このプロパティを使用すると、各インスタンスは、主要なプロパティ、ID データ、説明情報に加えて表示名を定義できます。 CIM_ManagedSystemElement クラスの Name プロパティも表示名として定義されます。ただし、多くの場合、Key としてサブクラス化されます。同じプロパティが、一貫性のない ID と表示名の両方を伝えることができるのは合理的ではありません。 Name が存在し、Key ではない場合 (LogicalDevice のインスタンスなど)、Name プロパティと ElementName プロパティの両方に同じ情報を含めることができます。このプロパティは、 CIM_ManagedElementから継承されます。

EnabledDefault

データ型: uint16
アクセスの種類: 読み取り専用

要素の EnabledState に対する管理者の既定の構成またはスタートアップ構成。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

EnabledState

データ型: uint16
アクセスの種類: 読み取り専用

要素の有効および無効の状態。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

値	説明
有効 2	ゲスト仮想マシンは合成マウスをサポートしています。
Disabled 3	ゲスト仮想マシンは合成マウスをサポートしていません。

ErrorCleared

データ型: boolean
アクセスの種類: 読み取り専用

LastErrorCode で報告されたエラーがクリアされたかどうかを示します。このプロパティは CIM_LogicalDeviceから継承されますが、使用されません。

ErrorDescription

データ型: string
アクセスの種類: 読み取り専用

LastErrorCode に記録されたエラーの詳細と、実行できる修正アクションに関する情報を提供する文字列。このプロパティは CIM_LogicalDeviceから継承されますが、使用されません。

利き手

データ型: uint16
アクセスの種類: 読み取り専用

右または左手の操作用のポインティングデバイスの構成。このプロパティは、 CIM_PointingDeviceから継承されます。

値	説明
0	Unknown
1	適用不可。
2	右利きの操作。
3	左利き操作。

HealthState

データ型: uint16
アクセスの種類: 読み取り専用

要素の現在の正常性。このプロパティは 、CIM_ManagedSystemElementから継承されます。

HorizontalPosition

データ型: 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)
Emigrating (10)
未移行 (11)
スナップショット処理 (12)
シャットダウン (13)
In Test (14)
移行中 (15)
In Service (16)
DMTF 予約済み (..)
ベンダー予約 済み (0x8000.. )

OperationalStatus

データ型: uint16 配列
アクセスの種類: 読み取り専用

要素の現在の状態。このプロパティは 、CIM_ManagedSystemElementから継承されます。

OtherEnabledState

データ型: string
アクセスの種類: 読み取り専用

EnabledState プロパティが 1 (Other) に設定されている場合の要素の有効または無効の状態。 EnabledState が 1 以外の値である場合、このプロパティは Null に設定する必要があります。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

OtherIdentifyingInfo

データ型: 文字列 配列
アクセスの種類: 読み取り専用

論理デバイスを識別するために使用できる、デバイス ID 情報以外の追加データ。このプロパティは 、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)
OK (1)
機能低下 (2)
エラー (3)
DMTF 予約済み (..)
ベンダー予約 済み (0x8000.. )

RequestedState

データ型: uint16
アクセスの種類: 読み取り専用

要素に対して最後に要求された状態または目的の状態。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

値	説明
12	適用しない

解像度

データ型: uint32
アクセスの種類: 読み取り専用

ポインティングデバイスのトラッキング解像度 (1 インチあたりのカウント数)。このプロパティは、 CIM_PointingDeviceから継承されます。

ScrollPosition

データ型: sint32
アクセスの種類: 読み取り専用
修飾子: 単位 ("ミッキー")

マウスデバイスの z 座標位置。

状態

データ型: string
アクセスの種類: 読み取り専用

オブジェクトの現在の状態。このプロパティは CIM_ManagedSystemElementから継承されますが、使用されません。

StatusDescriptions

データ型: 文字列 配列
アクセスの種類: 読み取り専用

さまざまな OperationalStatus 配列値を記述する文字列。このプロパティは 、CIM_ManagedSystemElementから継承されます。

StatusInfo

データ型: uint16
アクセスの種類: 読み取り専用

論理デバイスの現在の状態。このプロパティは CIM_LogicalDeviceから継承されますが、使用されません。

SystemCreationClassName

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen (256)

スコープシステムの作成クラス名。このプロパティは 、CIM_LogicalDeviceから継承されます。

Systemname

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen (256)

スコープシステムの名前。この値は、スコープ仮想マシンのMsvm_ComputerSystem クラスの Name プロパティの値に対応します。このプロパティは 、CIM_LogicalDeviceから継承されます。

TimeOfLastStateChange

データ型: datetime
アクセスの種類: 読み取り専用

要素の有効な状態が最後に変更された日時。要素の状態が変更されておらず、このプロパティが設定されている場合は、0 間隔の値に設定する必要があります。状態の変更が要求されたが、拒否された場合、またはまだ処理されていない場合は、プロパティを更新しないでください。このプロパティは CIM_EnabledLogicalElementから継承され、常に Null に設定 されます。

TotalPowerOnHours

データ型: uint64
アクセスの種類: 読み取り専用

このデバイスの電源が入った合計時間数。このプロパティは CIM_LogicalDeviceから継承されますが、使用されません。

TransitioningToState

データ型: uint16
アクセスの種類: 読み取り専用

インスタンスが遷移しているターゲットの状態を示します。このプロパティは CIM_EnabledLogicalElementから継承され、常に Null に設定 されます。

VerticalPosition

データ型: sint32
アクセスの種類: 読み取り専用

ポインティングデバイスの絶対 y 座標。

注釈

MSVM_SYNTHETICMOUSE クラスへのアクセスは、UAC フィルター処理によって制限される場合があります。詳細については、「ユーザーアカウント制御と WMI」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップアプリのみ]
名前空間	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
[DLL]	Vmms.exe

こちらもご覧ください

CIM_PointingDevice
CIM_PointingDevice
入力クラス

次の方法で共有