Msvm_Synthetic3DDisplayControllerSettingData 类

项目
06/13/2023

表示虚拟机的合成三维显示控制器的设置。此类仅适用于使用 RemoteFX 的虚拟机。

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

语法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_Synthetic3DDisplayControllerSettingData : CIM_ResourceAllocationSettingData
{
  string  InstanceID;
  string  Caption = "3D Display Controller Default Settings";
  string  Description = "Describes the default settings for the 3D video controller resource pool.";
  string  ElementName;
  uint16  ResourceType = 24;
  string  OtherResourceType;
  string  ResourceSubType = "Microsoft:Hyper-V:Synthetic 3D Display Controller";
  string  PoolID;
  uint16  ConsumerVisibility = 3;
  string  HostResource[];
  string  AllocationUnits = "count";
  uint64  VirtualQuantity = 1;
  uint64  Reservation = 1;
  uint64  Limit = 1;
  uint32  Weight = 0;
  boolean AutomaticAllocation = True;
  boolean AutomaticDeallocation = True;
  string  Parent;
  string  Connection[];
  string  Address;
  uint16  MappingBehavior;
  string  AddressOnParent;
  string  VirtualQuantityUnits = "count";
  uint8   MaximumScreenResolution;
  uint8   MaximumMonitors;
  uint64  VRAMSizeBytes;
};

成员

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

属性

属性

Msvm_Synthetic3DDisplayControllerSettingData 类具有这些属性。

Address

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

资源的地址。此属性继承自 CIM_ResourceAllocationSettingData。

这是一个只读属性，但如果 ResourceType 属性为 20 (图形控制器) ，则可以使用 Msvm_VirtualSystemManagementService 类的 ModifyResourceSettings 方法进行更改。

AddressOnParent

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

描述父级上下文中此资源的地址。 Parent 和 AddressOnParent 属性用于描述控制器关系以及控制器上设备的排序。此属性继承自 CIM_ResourceAllocationSettingData。

AllocationUnits

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

预留和限制属性使用的分配单位。此属性继承自 CIM_ResourceAllocationSettingData。

AutomaticAllocation

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

指示是否会自动分配资源。此属性继承自 CIM_ResourceAllocationSettingData。

AutomaticDeallocation

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

指示是否会自动解除分配资源。此属性继承自 CIM_ResourceAllocationSettingData。

Caption

数据类型： string
访问类型：只读
限定符： MaxLen (64)

对象的简短说明。此属性继承自 CIM_ManagedElement。

Connection

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

此资源连接到的设备。此属性继承自 CIM_ResourceAllocationSettingData。

这是一个只读属性，但如果 1) ResourceType 属性为 17 (串行端口) ，或 2) ResourceType 属性为 21 (存储区) 且 ResourceSubType 属性为“Microsoft 虚拟硬盘”，则可以使用 Msvm_VirtualSystemManagementService 类的 ModifyResourceSettings 方法对其进行更改。

ConsumerVisibility

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

使用者对已分配资源的可见性。此属性继承自 CIM_ResourceAllocationSettingData。

描述

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

对象的说明。此属性继承自 CIM_ManagedElement。

ElementName

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

对象的显示名称。此属性继承自 CIM_SettingData。更改此属性将更改关联的逻辑设备派生的元素名称。

HostResource

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

只能将一个主机资源分配给虚拟机中的每个设备，因此只能设置此数组的第一个元素。对于支持此功能的设备，请将 HostResource 数组的第一个元素设置为包含对要分配的基础主机资源的引用。此属性继承自 CIM_ResourceAllocationSettingData。

InstanceID

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

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

限制

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

虚拟机可以使用的最大相应主机资源量。此属性继承自 CIM_ResourceAllocationSettingData。

MappingBehavior

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

指定此资源如何映射到基础资源。此属性继承自 CIM_ResourceAllocationSettingData。

MaximumMonitors

数据类型： uint8
访问类型：读/写

可用于三维显示控制器的最大监视器数。监视器的最小数目为 1，最大数目取决于最大屏幕分辨率。下表定义了不同分辨率允许的最大监视器数。

解决方法	最大监视器数
1024 768	4
1280 1024	4
1600 1200	3
1920 1200	2

MaximumScreenResolution

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

指定三维显示控制器的最大屏幕分辨率。这必须是以下值之一。

1024 * 768 (0)

最大分辨率为 1024 768。

1280 * 1024 (1)

最大分辨率为 1280 1024。

1600 * 1200 (2)

最大分辨率为 1600 1200。

1920 * 1200 (3)

最大分辨率为 1920 1200。

2560 * 1600 (4)

最大分辨率为 2650 1600。

3840 * 2160 (5)

最大分辨率为 3840 2160。

注意

在 Windows 10 和 Windows Server 2016.msvm_synte 中添加

OtherResourceType

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

一个字符串，用于描述定义完善的值不可用且 ResourceType 的值 (其他) 时的资源类型。此属性继承自 CIM_ResourceAllocationSettingData。

Parent

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

资源的父级。此属性继承自 CIM_ResourceAllocationSettingData。

PoolID

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

从中分配此资源的资源池的标识符。此属性继承自 CIM_ResourceAllocationSettingData。

预留

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

虚拟机保留的 CPU 资源量。这些资源保证可供虚拟机使用。此属性继承自 CIM_ResourceAllocationSettingData。

ResourceSubType

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

描述此资源的实现特定子类型的字符串。例如，这可用于区分同一资源类型的不同模型。此属性继承自 CIM_ResourceAllocationSettingData。

ResourceType

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

此分配设置表示的资源类型。此属性继承自 CIM_ResourceAllocationSettingData。

VirtualQuantity

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

虚拟机中的核心总数。此属性继承自 CIM_ResourceAllocationSettingData。

VirtualQuantityUnits

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

指定 VirtualQuantity 属性的度量单位。此属性的值必须是 DSP0004 V2.5 或更高版本的附件 C.1 中定义的编程单位限定符的法定值。此属性继承自 CIM_ResourceAllocationSettingData。

VRAMSizeBytes

数据类型： uint64
访问类型：读/写

虚拟机的视频内存大小。

注意

在 Windows 10 和 Windows Server 2016 中添加。

(67108864)

(134217728)

(268435456)

(536870912)

(1073741824)

Weight

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

定义每个虚拟机处理器的权重的整数。满足所有预留后，托管平台的剩余物理处理器容量将根据虚拟机的相对权重分配给虚拟机。此属性继承自 CIM_ResourceAllocationSettingData。

范围：0 1000

要求

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

通过

Msvm_Synthetic3DDisplayControllerSettingData 类

语法

成员

属性

要求

反馈

其他资源