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類別具有這些方法。

方法	Description
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)	裝置處於警告狀態，但也會處於省電模式。

標題

資料類型： 字串

存取類型：唯讀

物件的簡短文字描述。 此屬性繼承自 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)
Disabled 2 (0x2)
Enabled 3 (0x3)	電源管理功能目前已啟用，但確切的功能集未知或資訊無法使用。
自動輸入的省電模式 4 (0x4)	裝置可以根據使用量或其他準則來變更其電源狀態。
Power State Settable 5 (0x5)	支援 SetPowerState 方法。 這個方法位於父 CIM_LogicalDevice 類別上，而且可以實作。 如需詳細資訊，請參閱 設計 Managed 物件格式 (MOF) 類別。
支援的電源迴圈 6 (0x6)	您可以叫用 SetPowerState 方法，並將 PowerState 參數設定為 5 (「Power Cycle」) 。
支援的計時電源 7 (0x7)	您可以使用PowerState 參數將 SetPowerState參數設定為 5 (「Power Cycle」) 和時間設定為特定日期和時間或開啟電源的間隔來叫用SetPowerState方法。

PowerManagementSupported

資料類型： 布林值

存取類型：唯讀

如果 為 TRUE，則裝置可以電源管理，也就是進入省電狀態。 如果 為 FALSE，則整數值 1 (「不支援」) 應該是 PowerManagementCapabilities 陣列中唯一的專案。

這個屬性不會指出電源管理功能目前是否已啟用，或者如果已啟用，則表示支援哪些功能。 如需詳細資訊，請參閱 PowerManagementCapabilities 陣列。

狀態

資料類型： 字串

存取類型：唯讀

物件的目前狀態。 此屬性繼承自 CIM_ManagedSystemElement。

包括下列值：

「OK」

「Error」

「已降級」

「Unknown」

「Pred Fail」

「Starting」

「停止」

「服務」

「Stressed」

「NonRecover」

「沒有連絡人」

「Lost Comm」

StatusInfo

資料類型： uint16

存取類型：唯讀

邏輯裝置的狀態。 如果此屬性不適用於邏輯裝置，則應該使用值 5 (「不適用」) 。 此屬性繼承自 CIM_LogicalDevice。

其他 (1 (0x1) )

未知 (2 (0x2) )

已啟用 (3 (0x3) )

停用 (4 (0x4) )

不適用 (5 (0x5) )

SystemCreationClassName

資料類型： 字串

存取類型：唯讀

界定系統的建立類別名稱。

SystemName

資料類型： 字串

存取類型：唯讀

界定系統的名稱。

規格需求

需求	值
最低支援的用戶端	Windows 8.1 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2012 R2 [僅限傳統型應用程式]
命名空間	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

另請參閱

CIM_LogicalDevice

CIM_LogicalDevice