Msvm_Keyboard 类

项目
06/13/2023

表示键盘设备。键盘是始终存在于虚拟机中的逻辑设备，因此不通过资源池进行分配。虚拟计算机系统中始终存在一个实例。

以下语法是简化的托管对象格式 (MOF) 代码，其中包含所有继承的属性。

语法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_Keyboard : CIM_UserDevice
{
  string   InstanceID;
  string   Caption = "Keyboard";
  string   Description = "Microsoft Virtual Keyboard";
  string   ElementName = "Keyboard";
  datetime InstallDate;
  string   Name = "Keyboard";
  uint16   OperationalStatus[] = { 2 };
  string   StatusDescriptions[] = { "OK" };
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 5;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  string   CreationClassName = "Msvm_Keyboard";
  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;
  string   Layout = "00000409";
  uint16   NumberOfFunctionKeys = 12;
  uint16   Password = 5;
  boolean  UnicodeSupported;
};

成员

Msvm_Keyboard 类具有以下类型的成员：

方法
属性

方法

Msvm_Keyboard 类具有以下方法。

方法	说明
EnableDevice	不支持此方法。
IsKeyPressed	检索密钥的键状态。
OnlineDevice	不支持此方法。
按键	模拟按键。
QuiesceDevice	不支持此方法。
ReleaseKey	模拟密钥释放。
RequestStateChange	请求更改元素的状态。
重置	重置虚拟键盘。
RestoreProperties	不支持此方法。
SaveProperties	不支持此方法。
SetPowerState	不支持此方法。
TypeCtrlAltDel	模拟 Ctrl+Alt+Del 键序列。
TypeKey	模拟按下释放键序列。
TypeScancodes	使用扫描代码模拟键序列。
TypeText	模拟一系列类型化字符。

属性

Msvm_Keyboard 类具有以下属性。

AdditionalAvailability

数据类型： uint16 数组
访问类型：只读

超出 可用性属性中指定的 设备的任何其他可用性和状态。 Availability 属性表示设备的主要状态和可用性。此属性继承自 CIM_LogicalDevice。

可用性

数据类型： uint16
访问类型：只读

设备的主要可用性和状态。此属性继承自 CIM_LogicalDevice。

AvailableRequestedStates

数据类型： uint16 数组
访问类型：只读

指示 RequestStateChange 方法的 RequestedState 参数的可能值。此属性继承自 CIM_EnabledLogicalElement，并且始终设置为 Null。

Caption

数据类型： string
访问类型：只读
限定符： MaxLen (64)

对象的简短说明。此属性继承自 CIM_ManagedElement。

CommunicationStatus

数据类型： uint16
访问类型：只读

指示检测与基础托管元素通信的能力。 Null 值指示未实现此属性。此属性继承自 CIM_ManagedSystemElement。

未知 (0)
不可用 (1)
通信正常 (2)
丢失通信 (3)
No Contact (4)
DMTF 保留 (。)
供应商预留 (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

数据类型： 字符串
访问类型：只读

用于唯一命名逻辑设备的地址或其他标识信息。此属性继承自 CIM_LogicalDevice，并且始终设置为“Microsoft：GUID”。

ElementName

数据类型： 字符串
访问类型：只读

对象的显示名称。此属性允许每个实例定义显示名称，以及其关键属性、标识数据和说明信息。 CIM_ManagedSystemElement 类的 Name 属性也定义为显示名称。但是，它通常被子类化为键。同一属性可以同时传达标识和显示名称是不一致的，这是不合理的。如果 Name 存在并且不是键 (（例如 ，对于 CIM_LogicalDevice) 的实例）， 则 Name 和 ElementName 属性中都可以显示相同的信息。此属性继承自 CIM_ManagedElement。

EnabledDefault

数据类型： uint16
访问类型：只读

元素的已启用状态的管理员默认或启动配置。此属性继承自 CIM_EnabledLogicalElement。

值	含义
2	Enabled

EnabledState

数据类型： uint16
访问类型：只读

指示元素的启用和禁用状态。它还可以指示这些请求状态之间的转换。例如，关闭 (value=4) 和开始 (value=10) 是启用和禁用之间的暂时性状态。

值	含义
Unknown 0	Unknown
其他 1	其他
已启用 2	元素正在执行或可能正在执行命令，将处理任何排队的命令，并将新请求排队。
已禁用 3	元素不会执行命令，并且会删除任何新请求。
关闭 4	元素正在进入“已禁用”状态。
不适用 5	元素不支持启用或禁用。
已启用但脱机 6	元素可能正在完成命令，并将删除任何新请求。
测试中 7	元素处于测试状态。
递延 8	元素可能正在完成命令，但它会将任何新请求排队。
Quiesce 9	元素已启用，但处于受限模式。元素的行为类似于“已启用”状态 (2) ，但它只处理一组受限的命令。所有其他请求已排队。
正在启动 10	元素正在进入 Enabled 状态 (2) 。新请求已排队。
DMTF 保留 11 32767	此值是保留的。
保留的供应商 32768 65535	此值是保留的。

ErrorCleared

数据类型： 布尔值
访问类型：只读

指示现在是否清除 LastErrorCode 中报告的错误。此属性继承自 CIM_LogicalDevice，但不使用它。

ErrorDescription

数据类型： 字符串
访问类型：只读

一个字符串，提供有关 LastErrorCode 中记录的错误的详细信息，以及有关可以采取的任何纠正措施的信息。此属性继承自 CIM_LogicalDevice，但不使用它。

HealthState

数据类型： uint16
访问类型：只读

元素的当前运行状况。此属性继承自 CIM_ManagedSystemElement，并且始终将它设置为 5 (正常) 。

IdentifyingDescriptions

数据类型： 字符串 数组
访问类型：只读

一个自由格式字符串数组，提供 OtherIdentifyingInfo 数组中条目背后的说明和详细信息。此属性继承自 CIM_LogicalDevice。

InstallDate

数据类型： datetime
访问类型：只读

创建虚拟机的日期和时间。此属性继承自 CIM_ManagedSystemElement。

InstanceID

数据类型： string
访问类型：只读
限定符：键

唯一标识此类的实例。此属性继承自 CIM_ManagedElement。

IsLocked

数据类型： 布尔值
访问类型：只读

指示设备是否已锁定，从而阻止用户输入或输出。此属性继承自 CIM_UserDevice。

LastErrorCode

数据类型： uint32
访问类型：只读

逻辑设备报告的最后一个错误代码。此属性继承自 CIM_LogicalDevice，但不使用它。

布局

数据类型： string
访问类型：只读

一个字符串，指示键盘的格式和布局。

MaxQuiesceTime

数据类型： uint64
访问类型：只读

此属性已弃用。此属性继承自 CIM_LogicalDevice，但不使用它。

名称

数据类型： string
访问类型：只读
限定符： MaxLen (1024)

对象的已知标签。当子类化时，此属性可以重写为键属性。此属性继承自 CIM_ManagedSystemElement。

NumberOfFunctionKeys

数据类型： uint16
访问类型：只读

键盘上的功能键数。

OperatingStatus

数据类型： uint16
访问类型：只读

提供元素操作条件的当前状态信息，并可用于提供有关 EnabledState 属性值的更多详细信息。 Null 值指示未实现此属性。此属性继承自 CIM_ManagedSystemElement。

未知 (0)
不可用 (1)
服务 (2)
开始 (3)
停止 (4)
已停止 (5)
中止 (6)
休眠 (7)
已完成 (8)
迁移 (9)
移民 (10)
移民 (11)
快照 (12)
正在关闭 (13)
在测试 (14)
转换 (15)
在 Service (16)
DMTF 保留 (。)
供应商预留 (0x8000。)

OperationalStatus

数据类型： uint16 数组
访问类型：只读

元素的当前状态。此属性继承自 CIM_ManagedSystemElement，并且始终设置为 2 (正常) 。

OtherEnabledState

数据类型： string
访问类型：只读

一个字符串，描述 EnabledState 属性设置为 1 时元素的启用或禁用状态， (Other) 。当 EnabledState 为除 1 以外的任何值时，此属性必须设置为 Null。此属性继承自 CIM_EnabledLogicalElement。

OtherIdentifyingInfo

数据类型： 字符串 数组
访问类型：只读

除设备 ID 信息外，可用于标识逻辑设备的任何其他数据。此属性继承自 CIM_LogicalDevice 并且始终设置为 Null。

密码

数据类型： uint16
访问类型：只读

指示是否在键盘上启用硬件级密码，从而阻止本地输入。

5

未实现。

PowerManagementCapabilities

数据类型： uint16 数组
访问类型：只读

设备的电源管理功能。此属性继承自 CIM_LogicalDevice，但不使用它。

PowerManagementSupported

数据类型： 布尔值
访问类型：只读

指示设备是否可以进行电源管理。此属性继承自 CIM_LogicalDevice，但不使用它。

PowerOnHours

数据类型： uint64
访问类型：只读

此设备自上次电源周期以来连续开机的小时数。此属性继承自 CIM_LogicalDevice，但不使用它。

PrimaryStatus

数据类型： uint16
访问类型：只读

提供高级别状态信息。此属性应与 DetailedStatus 属性结合使用，以提供元素及其子组件的高级和详细的运行状况。 Null 值指示未实现此属性。此属性继承自 CIM_ManagedSystemElement。

未知 (0)
确定 (1)
降级 (2)
错误 (3)
DMTF 保留 (。)
供应商预留 (0x8000。)

RequestedState

数据类型： uint16
访问类型：只读

元素的最后一个请求状态。

值	含义
不适用 12	不适用。

Status

数据类型： string
访问类型：只读

此属性继承自 CIM_ManagedSystemElement，但不使用它。

StatusDescriptions

数据类型： 字符串 数组
访问类型：只读

描述各种 OperationalStatus 数组值的字符串。此属性继承自 CIM_ManagedSystemElement，并且始终设置为“确定”。

StatusInfo

数据类型： uint16
访问类型：只读

逻辑设备的当前状态。此属性继承自 CIM_LogicalDevice，但不使用它。

SystemCreationClassName

数据类型： string
访问类型：只读
限定符： MaxLen (256)

范围系统的创建类名称。此属性继承自 CIM_LogicalDevice，并设置为“Msvm_ComputerSystem”。

SystemName

数据类型： string
访问类型：只读
限定符： MaxLen (256)

范围系统的名称。此值对应于范围虚拟机的 Msvm_ComputerSystem 类的 Name 属性的值。此属性继承自 CIM_LogicalDevice。

TimeOfLastStateChange

数据类型： datetime
访问类型：只读

元素的启用状态上次更改的日期和时间。如果元素的状态未更改并且填充了此属性，则必须将其设置为 0 间隔值。如果已请求状态更改，但被拒绝或尚未处理，则不得更新属性。此属性继承自 CIM_EnabledLogicalElement，并且始终设置为 Null。

TotalPowerOnHours

数据类型： uint64
访问类型：只读

此设备通电的总小时数。此属性继承自 CIM_LogicalDevice，但不使用它。

TransitioningToState

数据类型： uint16
访问类型：只读

指示实例要转换到的目标状态。此属性继承自 CIM_EnabledLogicalElement，并且始终设置为 Null。

UnicodeSupported

数据类型： 布尔值
访问类型：只读

指示虚拟键盘是否支持 Unicode 字符。这可以是以下值之一。

值	含义
True	虚拟键盘支持 Unicode 字符。
错误	虚拟键盘不支持 Unicode 字符。

备注

UAC 筛选可能会限制对 Msvm_Keyboard 类的访问。有关详细信息，请参阅用户帐户控制和 WMI。

要求

要求	值
最低受支持的客户端	Windows 8 [仅限桌面应用]
最低受支持的服务器	Windows Server 2012 [仅限桌面应用]
命名空间	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

通过

Msvm_Keyboard 类

语法

成员

方法

属性

备注

要求

另请参阅

反馈

其他资源