表示键盘设备。 键盘是始终存在于虚拟机中的逻辑设备,因此不通过资源池进行分配。 虚拟计算机系统中始终存在一个实例。
以下语法是简化的托管对象格式 (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 
- 
访问类型:只读 
元素的最后一个请求状态。
| 值 | 含义 | 
|---|---|
| 
 | 不适用。 | 
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 字符。 这可以是以下值之一。
| 值 | 含义 | 
|---|---|
| 
 | 虚拟键盘支持 Unicode 字符。 | 
| 
 | 虚拟键盘不支持 Unicode 字符。 | 
备注
UAC 筛选可能会限制对 Msvm_Keyboard 类的访问。 有关详细信息,请参阅 用户帐户控制和 WMI。
要求
| 要求 | 值 | 
|---|---|
| 最低受支持的客户端 | Windows 8 [仅限桌面应用] | 
| 最低受支持的服务器 | Windows Server 2012 [仅限桌面应用] | 
| 命名空间 | Root\Virtualization\V2 | 
| MOF | 
 | 
| DLL | 
 |