Msvm_S3DisplayController 類別

發行項
06/13/2023

表示每個虛擬機器組態中存在的模擬 S3 控制器狀態。虛擬機器中隨時只能有一個顯示控制器作用中。

注意

此類別僅適用于第 1 代虛擬機器。

下列語法是簡化 Managed 物件格式 (MOF) 程式碼，並包含所有繼承的屬性。

語法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_S3DisplayController : CIM_DisplayController
{
  string   InstanceID;
  string   Caption = "Display Controller";
  string   Description = "Microsoft Emulated Display Controller";
  string   ElementName = "Display Controller";
  datetime InstallDate;
  string   Name = "Display Controller";
  uint16   OperationalStatus[] = { 2 };
  string   StatusDescriptions[] = { "OK" };
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  string   EnabledState = 3;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  uint16   CreationClassName = "Msvm_S3DisplayController";
  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;
  datetime TimeOfLastReset;
  uint16   ProtocolSupported = 1;
  uint32   MaxNumberControlled = 1;
  string   ProtocolDescription = "Video";
  string   VideoProcessor = "Virtual S3 Video Processor";
  uint16   VideoMemoryType = 2;
  string   OtherVideoMemoryType;
  uint32   NumberOfVideoPages = 32768;
  uint32   MaxMemorySupported = 134217728;
  uint16   AcceleratorCapabilities[] = { 2 };
  string   CapabilityDescriptions[] = { "Graphics Accelerator" };
  string   OtherVideoArchitecture;
  uint16   VideoArchitecture;
};

成員

Msvm_S3DisplayController類別具有下列類型的成員：

方法
屬性

方法

Msvm_S3DisplayController類別具有這些方法。

方法	Description
EnableDevice	不支援這個方法。
OnlineDevice	不支援這個方法。
QuiesceDevice	不支援這個方法。
RequestStateChange	要求狀態變更。
重置	重設虛擬裝置。
RestoreProperties	不支援這個方法。
SaveProperties	不支援這個方法。
SetPowerState	不支援這個方法。

屬性

Msvm_S3DisplayController類別具有這些屬性。

AcceleratorCapabilities

資料類型： uint16 陣列
存取類型：唯讀

顯示控制器的圖形和 3D 功能。此屬性繼承自 CIM_DisplayController。

AdditionalAvailability

資料類型： uint16 陣列
存取類型：唯讀

裝置的任何其他可用性和狀態。此屬性繼承自 CIM_LogicalDevice。

可用性

資料類型： uint16
存取類型：唯讀

裝置的主要可用性和狀態。此屬性繼承自 CIM_LogicalDevice。

值	意義
6	不適用

AvailableRequestedStates

資料類型： uint16 陣列
存取類型：唯讀

指出RequestStateChange方法之 RequestedState參數的可能值。此屬性繼承自 CIM_EnabledLogicalElement，而且一律設定為 Null。

CapabilityDescriptions

資料類型：字串陣列
存取類型：唯讀

自由格式字串陣列，提供 AcceleratorCapabilities 陣列中所指出之任何視訊快速鍵功能的更詳細說明。此陣列的每個專案都與位於相同索引的 AcceleratorCapabilities 陣列中的專案相關。此屬性繼承自 CIM_DisplayController。

標題

資料類型：字串
存取類型：唯讀

物件的簡短描述。此屬性繼承自 CIM_ManagedElement。

CommunicationStatus

資料類型： uint16
存取類型：唯讀

指出檢測能夠與基礎 Managed 專案通訊。 Null值表示這個屬性未實作。此屬性繼承自 CIM_ManagedSystemElement。

未知 (0)
無法使用 (1)
通訊正常 (2)
遺失通訊 (3)
沒有連絡人 (4)
DMTF 保留 (。。)
廠商保留 (0x8000。)

CreationClassName

資料類型： uint16
存取類型：唯讀

建立實例時所使用的類別或子類別名稱。此屬性繼承自 CIM_LogicalDevice，而且一律設定為「Msvm_S3DisplayController」。

說明

資料類型：字串
存取類型：唯讀

對物件的描述。此屬性繼承自 CIM_ManagedElement。

DetailedStatus

資料類型： uint16
存取類型：唯讀

使用其他狀態詳細資料來補充 PrimaryStatus 屬性。 Null值表示這個屬性未實作。此屬性繼承自 CIM_ManagedSystemElement。

無法使用 (0)
沒有其他資訊 (1)
壓力 (2)
預測性失敗 (3)
無法復原的錯誤 (4)
支援錯誤中的實體 (5)
DMTF 保留 (。。)
廠商保留 (0x8000。)

DeviceID

資料類型：字串
存取類型：唯讀

用來唯一命名邏輯裝置的位址或其他識別資訊。此屬性繼承自 CIM_LogicalDevice。

ElementName

資料類型：字串
存取類型：唯讀

物件的顯示名稱。此屬性繼承自 CIM_ManagedElement。

EnabledDefault

資料類型： uint16
存取類型：唯讀

啟用專案狀態的系統管理員預設或啟動組態。此屬性繼承自 CIM_EnabledLogicalElement。

值	意義
2	啟用
3	已停用

EnabledState

資料類型：字串
存取類型：唯讀

專案的啟用和停用狀態。它也可以指出這些要求狀態之間的轉換。這個屬性繼承自 CIM_EnabledLogicalElement，而且一律會設定為 2 (Enabled) 或 3 (Disabled) 。

值	意義
2	啟用
3	已停用

ErrorCleared

資料類型： 布林值
存取類型：唯讀

指出 LastErrorCode 中回報的錯誤現在是否已清除。此屬性繼承自 CIM_LogicalDevice，但不會使用。

ErrorDescription

資料類型：字串
存取類型：唯讀

字串，提供有關 LastErrorCode 中所記錄之錯誤的詳細資訊，以及可採取之任何更正動作的相關資訊。此屬性繼承自 CIM_LogicalDevice，但不會使用。

HealthState

資料類型： uint16
存取類型：唯讀

專案的目前健全狀況。這個屬性工作表示這個專案的健康情況，但不一定是其子元件的健康情況。可能的值為 0 到 30，其中 5 表示元素狀況完全良好，而 30 表示元素完全非功能。此屬性繼承自 CIM_ManagedSystemElement。

值	意義
5	確定

IdentifyingDescriptions

資料類型：字串陣列
存取類型：唯讀

自由格式字串的陣列，提供 OtherIdentificationInfo 屬性陣列中專案背後的說明和詳細資料。此屬性繼承自 CIM_LogicalDevice，而且一律會設定為 Null。

InstallDate

資料類型： datetime
存取類型：唯讀

建立虛擬機器組態的日期和時間。此屬性繼承自 CIM_ManagedSystemElement。

InstanceID

資料類型：字串
存取類型：唯讀
限定詞：金鑰

唯一識別這個類別的實例。此屬性繼承自 CIM_ManagedElement。

LastErrorCode

資料類型： uint32
存取類型：唯讀

邏輯裝置報告的最後一個錯誤碼。此屬性繼承自 CIM_LogicalDevice，但不會使用。

MaxMemorySupported

資料類型： uint32
存取類型：唯讀

支援的記憶體數量上限，以位元組為單位。此屬性繼承自 CIM_DisplayController。

MaxNumberControlled

資料類型： uint32
存取類型：唯讀

此控制器支援的直接可定址實體數目上限。如果數位未知或無限制，則應該使用 0 的值。控制器用來存取受控制裝置的通訊協定。此屬性繼承自 CIM_Controller。

MaxQuiesceTime

資料類型： uint64
存取類型：唯讀

這個屬性已被取代。此屬性繼承自 CIM_LogicalDevice。

名稱

資料類型：字串
存取類型：唯讀

已知物件的標籤。此屬性繼承自 CIM_ManagedSystemElement。

NumberOfVideoPages

資料類型： uint32
存取類型：唯讀

提供目前解析度和可用記憶體支援的視訊頁數。此屬性繼承自 CIM_DisplayController。

OperatingStatus

資料類型： uint16
存取類型：唯讀

提供元素作業條件的目前狀態資訊，並可用來提供 有關 EnabledState 屬性值的詳細資料。 Null值表示這個屬性未實作。此屬性繼承自 CIM_ManagedSystemElement。

未知 (0)
無法使用 (1)
服務 (2)
從 (3 開始)
停止 (4)
已停止 (5)
中止 (6)
休眠 (7)
已完成 (8)
移轉 (9)
Emigrating (10)
( 11)
快照集 (12)
關閉 (13)
在測試 (14)
轉換 (15)
在 Service (16)
DMTF 保留 (。。)
廠商保留 (0x8000。)

OperationalStatus

資料類型： uint16 陣列
存取類型：唯讀

物件的目前狀態。此屬性繼承自 CIM_ManagedSystemElement，而且每個陣列元素一律會設定為 2 (OK) 。

OtherEnabledState

資料類型：字串
存取類型：唯讀

當 EnabledState屬性設定為 1 (Other) 時，元素的啟用或停用狀態。當EnabledState是 1 以外的任何值時，此屬性必須設定為Null。此屬性繼承自 CIM_EnabledLogicalElement，而且一律會設定為 Null。

OtherIdentifyingInfo

資料類型：字串陣列
存取類型：唯讀

裝置識別碼資訊以外的任何其他資料，可用來識別邏輯裝置。此屬性繼承自 CIM_LogicalDevice，而且一律會設定為 Null。

OtherVideoArchitecture

資料類型：字串
存取類型：唯讀

當 VideoArchitecture 屬性為 1 (「Other」) 時，描述視訊架構類型的字串。此屬性繼承自 CIM_DisplayController。

OtherVideoMemoryType

資料類型：字串
存取類型：唯讀

當實例的 VideoMemoryType 屬性為 1 (Other) 時，視訊記憶體類型。此屬性繼承自 CIM_DisplayController。

PowerManagementCapabilities

資料類型： uint16 陣列
存取類型：唯讀

裝置的電源管理功能。此屬性繼承自 CIM_LogicalDevice，但不會使用。

PowerManagementSupported

資料類型： 布林值
存取類型：唯讀

指出裝置是否可以進行電源管理。此屬性繼承自 CIM_LogicalDevice，但不會使用。

PowerOnHours

資料類型： uint64
存取類型：唯讀

自上次電源週期以來，此裝置已開啟的連續時數。此屬性繼承自 CIM_LogicalDevice，但不會使用。

PrimaryStatus

資料類型： uint16
存取類型：唯讀

提供高階狀態資訊。此屬性應該與 DetailedStatus 屬性搭配使用，以提供元素及其子元件的高階和詳細健全狀態。 Null值表示這個屬性未實作。此屬性繼承自 CIM_ManagedSystemElement。

未知 (0)
確定 (1)
降級 (2)
錯誤 (3)
DMTF 保留 (。。)
廠商保留 (0x8000。)

ProtocolDescription

資料類型：字串
存取類型：唯讀

字串，提供與控制器所支援通訊協定相關的詳細資訊。此屬性繼承自 CIM_Controller。

ProtocolSupported

資料類型： uint16
存取類型：唯讀

控制器用來存取受控制裝置的通訊協定。此屬性繼承自 CIM_Controller。

RequestedState

資料類型： uint16
存取類型：唯讀

專案的最後一個要求或所需狀態。專案的實際狀態是由 EnabledState表示。提供這個屬性來比較上次要求和目前啟用或停用的狀態。此屬性繼承自 CIM_EnabledLogicalElement。

值	意義
12	不適用

狀態

資料類型：字串
存取類型：唯讀

物件的目前狀態。此屬性繼承自 CIM_ManagedSystemElement，但不會使用。

StatusDescriptions

資料類型：字串陣列
存取類型：唯讀

描述各種 OperationalStatus 陣列值的字串。此屬性繼承自 CIM_ManagedSystemElement，而且每個陣列元素一律設定為「OK」。

StatusInfo

資料類型： uint16
存取類型：唯讀

邏輯裝置的目前狀態。此屬性繼承自 CIM_LogicalDevice，但不會使用。

SystemCreationClassName

資料類型：字串
存取類型：唯讀

界定系統的建立類別名稱。此屬性繼承自 CIM_LogicalDevice。

SystemName

資料類型：字串
存取類型：唯讀

範圍虛擬機器的唯一識別碼。此屬性繼承自 CIM_LogicalDevice。

TimeOfLastReset

資料類型： datetime
存取類型：唯讀

上次開啟虛擬機器電源的時間。此屬性繼承自 CIM_Controller。

TimeOfLastStateChange

資料類型： datetime
存取類型：唯讀

上次變更專案啟用狀態的日期或時間。此屬性繼承自 CIM_EnabledLogicalElement。

TotalPowerOnHours

資料類型： uint64
存取類型：唯讀

此裝置已啟動的時數總計。此屬性繼承自 CIM_LogicalDevice，但不會使用。

TransitioningToState

資料類型： uint16
存取類型：唯讀

指出實例正在轉換的目標狀態。此屬性繼承自 CIM_EnabledLogicalElement，而且一律會設定為 Null。

VideoArchitecture

資料類型： uint16
存取類型：唯讀

指定用來產生視訊訊號的顯示控制器視訊架構。通常，專用視訊處理器會根據指定的架構產生視訊訊號。這是顯示控制器最大解析度功能的指標。此屬性繼承自 CIM_DisplayController。

未知 (0)
其他 (1)
CGA (2)
EGA (3)
VGA (4)
SVGA (5)
MDA (6)
HGC (7)
MCGA (8)
8514A (9)
XGA (10)
線性框架緩衝區 (11)
PC-98 (160)
DMTF 保留 (。。)
廠商保留 (0x8000。)

VideoMemoryType

資料類型： uint16
存取類型：唯讀

視訊記憶體的類型。此屬性繼承自 CIM_DisplayController。

VideoProcessor

資料類型：字串
存取類型：唯讀

描述視訊處理器/控制器的字串。此屬性繼承自 CIM_DisplayController。

備註

Msvm_S3DisplayController 類別的 存取可能會受到 UAC 篩選的限制。如需詳細資訊，請參閱使用者帳戶控制和 WMI。

規格需求

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

另請參閱

CIM_DisplayController
CIM_DisplayController
視訊類別

共用方式為

Msvm_S3DisplayController 類別

語法

成員

方法

屬性

備註

規格需求

另請參閱

意見反應

其他資源