Msvm_SyntheticDisplayController 类

项目
06/13/2023

表示每个虚拟机配置中存在的合成显示控制器的状态。在任何时候，虚拟机中只能有一个显示控制器处于活动状态，并且只有在来宾操作系统已加载所需的视频加速服务时，才能激活合成控制器。

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

语法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_SyntheticDisplayController : CIM_DisplayController
{
  string   InstanceID;
  string   Caption = "Display Controller";
  string   Description = "Microsoft Synthetic 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;
  string   OtherEnabledState;
  uint16   RequestedState;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  uint16   CreationClassName = "Msvm_SyntheticDisplayController";
  string   DeviceID = "Microsoft:GUID";
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability = 6;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   OtherIdentifyingInfo[];
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[] = { 6 };
  uint64   MaxQuiesceTime;
  datetime TimeOfLastReset;
  uint16   ProtocolSupported = 1;
  uint32   MaxNumberControlled = 1;
  string   ProtocolDescription = "Video";
  string   VideoProcessor = "Synthetic Video Processor";
  uint16   VideoMemoryType = 2;
  string   OtherVideoMemoryType;
  uint32   NumberOfVideoPages = 1024;
  uint32   MaxMemorySupported = 4194304;
  uint16   AcceleratorCapabilities[] = { 2 };
  string   CapabilityDescriptions[] = { "Graphics Accelerator" };
  string   OtherVideoArchitecture;
  uint16   VideoArchitecture;
};

成员

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

方法
属性

方法

Msvm_SyntheticDisplayController 类具有这些方法。

方法	说明
EnableDevice	不支持此方法。
OnlineDevice	不支持此方法。
QuiesceDevice	不支持此方法。
RequestStateChange	请求状态更改。
重置	重置虚拟设备。
RestoreProperties	不支持此方法。
SaveProperties	不支持此方法。
SetPowerState	不支持此方法。

属性

Msvm_SyntheticDisplayController 类具有这些属性。

AcceleratorCapabilities

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

显示控制器的图形和三维功能。此属性继承自 CIM_DisplayController，并且始终设置为 2 (图形加速器) 。

AdditionalAvailability

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

此属性继承自 CIM_LogicalDevice，并且始终设置为 6 (不适用) 。

可用性

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

此属性继承自 CIM_LogicalDevice，并且始终设置为 6 (不适用) 。

AvailableRequestedStates

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

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

CapabilityDescriptions

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

自由格式字符串数组，为 AcceleratorCapabilities 属性数组中指示的任何视频加速器功能提供更详细的说明。此数组的每个条目都与位于同一索引处的 AcceleratorCapabilities 属性数组中的条目相关。此属性继承自 CIM_DisplayController，并且始终设置为“图形加速器”。

Caption

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

对象的简短说明。此属性继承自 CIM_ManagedElement，并且始终设置为“显示控制器”。

CommunicationStatus

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

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

未知 (0)
不可用 (1)
通信正常 (2)
丢失通信 (3)
No Contact (4)
DMTF 保留 (。)
供应商预留 (0x8000。)

CreationClassName

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

创建实例时使用的类或子类的名称。此属性继承自 CIM_LogicalDevice，并且始终设置为“Msvm_SyntheticDisplayController”。

描述

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

对象的说明。此属性继承自 CIM_ManagedElement，并且始终设置为“Microsoft 合成显示控制器”。

DetailedStatus

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

使用其他状态详细信息补充 PrimaryStatus 属性。 Null 值指示未实现此属性。此属性继承自 CIM_ManagedSystemElement。

不可用 (0)
无其他信息 (1)
压力 (2)
预测故障 (3)
不可恢复的错误 (4)
支持错误 5 (中的实体)
DMTF 保留 (。)
供应商预留 (0x8000。)

DeviceID

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

此属性继承自 CIM_LogicalDevice，并且始终设置为“Microsoft：GUID”。

ElementName

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

对象的显示名称。此属性继承自 CIM_ManagedElement，默认情况下始终设置为“显示控制器”。

EnabledDefault

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

元素的启用状态的管理员默认或启动配置。此属性继承自 CIM_EnabledLogicalElement，并且始终设置为 2 (Enabled) 。

EnabledState

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

元素的启用和禁用状态。它还可以指示这些请求状态之间的转换。此属性继承自 CIM_EnabledLogicalElement，并且始终设置为 2 (Enabled) 或 3 (Disabled) 。

ErrorCleared

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

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

ErrorDescription

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

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

HealthState

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

元素的当前运行状况。此属性表示此元素的运行状况，但不一定表示其子元素的运行状况。可能的值为 0 到 30，其中 5 表示元素完全正常，30 表示元素完全无功能。此属性继承自 CIM_ManagedSystemElement，并且始终设置为 5 (正常) 。

IdentifyingDescriptions

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

此属性继承自 CIM_LogicalDevice，并且始终设置为 Null。

InstallDate

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

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

InstanceID

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

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

LastErrorCode

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

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

MaxMemorySupported

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

支持的最大内存量（以字节为单位）。此属性继承自 CIM_DisplayController，并且始终设置为 4，194，304 (0x400000) 。

MaxNumberControlled

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

此控制器支持的直接可寻址实体的最大数目。如果数字未知或无限制，则应使用值 0。控制器用于访问受控设备的协议。此属性继承自 CIM_Controller，并且始终设置为 1。

MaxQuiesceTime

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

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

名称

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

对象的已知标签。此属性继承自 CIM_ManagedSystemElement，与 ElementName 属性相同。

NumberOfVideoPages

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

给定当前分辨率和可用内存时支持的视频页数。此属性继承自 CIM_DisplayController，并且始终设置为 1024。

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，并且始终设置为 Null。

OtherIdentifyingInfo

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

此属性继承自 CIM_LogicalDevice，并且始终设置为 Null。

OtherVideoArchitecture

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

当 VideoArchitecture 属性为 1 (“Other”) 时描述视频体系结构类型的字符串。此属性继承自 CIM_DisplayController。

OtherVideoMemoryType

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

当实例的 VideoMemoryType 属性为 1 (Other) 时的视频内存类型。此属性继承自 CIM_DisplayController，并且始终设置为 Null。

PowerManagementCapabilities

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

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

PowerManagementSupported

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

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

PowerOnHours

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

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

PrimaryStatus

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

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

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

ProtocolDescription

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

一个字符串，提供与控制器支持的协议相关的详细信息。此属性继承自 CIM_Controller，并且始终设置为“Video”。

ProtocolSupported

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

控制器用于访问受控设备的协议。此属性继承自 CIM_Controller，并且始终设置为 1 (Other) 。

RequestedState

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

元素的最后一个请求或所需状态。元素的实际状态由 EnabledState 表示。提供此属性用于比较上次请求的状态和当前的启用或禁用状态。 CIM_EnabledLogicalElement的特定实例可能不支持 RequestStateChange。如果发生这种情况，则使用值 12 (不适用) 。此属性继承自 CIM_EnabledLogicalElement，并设置为 2 (Enabled) 、3 (Disabled) 或 12 (Not Applicable) 。

Status

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

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

StatusDescriptions

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

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

StatusInfo

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

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

SystemCreationClassName

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

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

SystemName

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

范围虚拟机的唯一标识符。此属性继承自 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，并且始终设置为 2 (VRAM) 。

VideoProcessor

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

描述视频处理器/控制器的字符串。此属性继承自 CIM_DisplayController，并且始终设置为“合成视频处理器”。

备注

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

要求

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

另请参阅

CIM_DisplayController
CIM_DisplayController
视频类

通过

Msvm_SyntheticDisplayController 类

语法

成员

方法

属性

备注

要求

另请参阅

反馈

其他资源