通过

Msvm_GuestServiceInterfaceComponent 类

  • 项目

表示来宾服务接口组件的状态，该组件提供一种机制，用于从主机系统上的管理接口与虚拟机进行交互。 此类派生自 CIM_LogicalDevice 类。

下面的语法从 MOF 代码简化而来，包含所有继承属性。

语法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_GuestServiceInterfaceComponent : CIM_LogicalDevice
{
  uint16   Availability;
  string   Caption;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   Description;
  string   DeviceID;
  boolean  ErrorCleared;
  string   ErrorDescription;
  datetime InstallDate;
  uint32   LastErrorCode;
  string   Name;
  string   PNPDeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  string   Status;
  uint16   StatusInfo;
  string   SystemCreationClassName;
  string   SystemName;
};

成员

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

方法

Msvm_GuestServiceInterfaceComponent 类具有这些方法。

方法 说明
RequestStateChange 请求将来宾服务接口组件的状态更改为指定值。
重 置 请求重置逻辑设备。 未由 WMI 实现。
SetPowerState 定义逻辑设备的所需电源状态，以及设备何时应进入该状态。 未由 WMI 实现。

属性

Msvm_GuestServiceInterfaceComponent 类具有以下属性。

可用性

数据类型： uint16

访问类型：只读

设备的可用性和状态。

值 含义
其他
1 (0x1)
Unknown
2 (0x2)
运行/全功率
3 (0x3)
警告
4 (0x4)
测试中
5 (0x5)
不适用
6 (0x6)
关闭电源
7 (0x7)
线下
8 (0x8)
下班
9 (0x9)
已降级
10 (0xA)
未安装
11 (0xB)
安装错误
12 (0xC)
省电 - 未知
13 (0xD)
已知设备处于节电模式，但其确切状态未知。
省电 - 低功耗模式
14 (0xE)
设备处于省电状态，但仍可正常运行，性能可能会下降。
省电 - 待机
15 (0xF)
设备无法正常工作，但可以快速通电。
电源周期
16 (0x10)
省电 - 警告
17 (0x11)
设备处于警告状态，不过也处于节电模式。

Caption

数据类型： 字符串

访问类型：只读

对象的简短文本说明。 此属性继承自 CIM_ManagedSystemElement。

ConfigManagerErrorCode

数据类型： uint32

访问类型：只读

Win32 Configuration Manager错误代码。

值 含义
0 (0x0)
设备工作正常。
1 (0x1)
设备配置不正确。
2 (0x2)
Windows 无法加载此设备的驱动程序。
3 (0x3)
此设备的驱动程序可能已损坏，或者系统内存或其他资源可能不足。
4 (0x4)
设备无法正常工作。 其中一个驱动程序或注册表可能已损坏。
5 (0x5)
设备的驱动程序需要 Windows 无法管理的资源。
6 (0x6)
设备的启动配置与其他设备冲突。
7 (0x7)
无法筛选。
8 (0x8)
缺少设备的驱动程序加载程序。
9 (0x9)
设备无法正常工作;控制固件错误地报告了设备的资源。
10 (0xA)
设备无法启动。
11 (0xB)
设备失败。
12 (0xC)
设备找不到足够的可用资源来使用。
13 (0xD)
Windows 无法验证设备的资源。
14 (0xE)
在重启计算机之前，设备无法正常工作。
15 (0xF)
设备由于可能的重新枚举问题而无法正常工作。
16 (0x10)
Windows 无法识别设备使用的所有资源。
17 (0x11)
设备正在请求未知资源类型。
18 (0x12)
必须重新安装设备驱动程序。
19 (0x13)
使用 VxD 加载程序失败。
20 (0x14)
注册表可能已损坏。
21 (0x15)
系统故障。 如果更改设备驱动程序无效，请参阅硬件文档。 Windows 正在删除设备。
22 (0x16)
设备已禁用。
23 (0x17)
系统故障。 如果更改设备驱动程序无效，请参阅硬件文档。
24 (0x18)
设备不存在、工作不正常或未安装其所有驱动程序。
25 (0x19)
Windows 仍在设置设备。
26 (0x1A)
Windows 仍在设置设备。
27 (0x1B)
设备没有有效的日志配置。
28 (0x1C)
未安装设备驱动程序。
29 (0x1D)
设备已禁用;设备固件未提供所需的资源。
30 (0x1E)
设备正在使用另一个设备正在使用的 IRQ 资源。
31 (0x1F)
设备无法正常工作;Windows 无法加载所需的设备驱动程序。

ConfigManagerUserConfig

数据类型： 布尔值

访问类型：只读

如果 为 TRUE，则设备使用的是用户定义的配置。

CreationClassName

数据类型： 字符串

访问类型：只读

创建实例时使用的类或子类的名称。 与 类的其他键属性一起使用时，此属性允许唯一标识类及其子类的所有实例。

描述

数据类型： 字符串

访问类型：只读

对象的文本说明。 此属性继承自 CIM_ManagedSystemElement。

DeviceID

数据类型： 字符串

访问类型：只读

用于唯一命名逻辑设备的地址或其他标识信息。

ErrorCleared

数据类型： 布尔值

访问类型：只读

如果 为 TRUE，则 现在清除 LastErrorCode 属性中报告的错误。

ErrorDescription

数据类型： 字符串

访问类型：只读

自由格式字符串，提供有关 LastErrorCode 属性中记录的错误和要执行的纠正操作的信息。

InstallDate

数据类型： datetime

访问类型：只读

对象的安装日期和时间。 此属性不需要值来指示已安装 对象。 此属性继承自 CIM_ManagedSystemElement。

LastErrorCode

数据类型： uint32

访问类型：只读

逻辑设备报告的最后一个错误代码。

名称

数据类型： 字符串

访问类型：只读

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

PNPDeviceID

数据类型： 字符串

访问类型：只读

指示逻辑设备的 Win32 即插即用设备标识符。

示例：“*PNP030b”

PowerManagementCapabilities

数据类型： uint16 数组

访问类型：只读

逻辑设备的特定电源相关功能的数组。 此属性继承自 CIM_LogicalDevice。

值 含义
Unknown
0 (0x0)
不支持
1 (0x1)
已禁用
2 (0x2)
已启用
3 (0x3)
电源管理功能当前已启用，但确切的功能集未知或信息不可用。
自动输入的节能模式
4 (0x4)
设备可以根据使用情况或其他条件更改其电源状态。
电源状态可设置
5 (0x5)
支持 SetPowerState 方法。 此方法在父 CIM_LogicalDevice 类上找到，并且可以实现。 有关详细信息，请参阅 设计托管对象格式 (MOF) 类。
支持电源循环
6 (0x6)
可以使用 PowerState 参数设置为 5 (“Power Cycle”) 调用 SetPowerState 方法。
支持定时开机
7 (0x7)
可以使用 PowerState参数设置为 5 (“Power Cycle”) 和时间设置为开机的特定日期和时间或间隔来调用 SetPowerState 方法。

PowerManagementSupported

数据类型： 布尔值

访问类型：只读

如果 为 TRUE，则可以对设备进行电源管理，即进入省电状态。 如果 为 FALSE，则整数值 1 (“不支持”) 应为 PowerManagementCapabilities 数组中的唯一条目。

此属性不指示当前是否已启用电源管理功能，或者如果已启用，则支持哪些功能。 有关详细信息，请参阅 PowerManagementCapabilities 数组。

Status

数据类型： string

访问类型：只读

对象的当前状态。 此属性继承自 CIM_ManagedSystemElement。

包括以下值：

“确定”

“错误”

“已降级”

“未知”

“Pred Fail”

“正在启动”

“正在停止”

“Service”

“Stressed”

“NonRecover”

“无联系人”

“Lost Comm”

StatusInfo

数据类型： uint16

访问类型：只读

逻辑设备的状态。 如果此属性不适用于逻辑设备，则应使用值 5 (“Not Applicable”) 。 此属性继承自 CIM_LogicalDevice。

其他 (1 (0x1) )

未知 (2 (0x2) )

已启用 (3 (0x3) )

已禁用 (4 (0x4) )

不适用 (5 (0x5) )

SystemCreationClassName

数据类型： string

访问类型：只读

确定系统的创建类名称的范围。

SystemName

数据类型： string

访问类型：只读

确定系统名称的范围。

要求

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

另请参阅

CIM_LogicalDevice

CIM_LogicalDevice