Msvm_Synthetic3DDisplayControllerSettingData 類別

發行項
06/13/2023

代表虛擬機器之綜合 3D 顯示控制器的設定。這個類別只適用于使用 RemoteFX 的虛擬機器。

下列語法是簡化 Managed Object Format (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類別具有這些屬性。

位址

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

資源的位址。此屬性繼承自 CIM_ResourceAllocationSettingData。

這是唯讀屬性，但如果ResourceType屬性是 20 (Graphics 控制器) ，則可以使用Msvm_VirtualSystemManagementService類別的ModifyResourceSettings方法來變更。

AddressOnParent

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

描述父系內容中此資源的位址。 Parent和AddressOnParent屬性可用來描述控制器關聯性，以及控制器上的裝置順序。此屬性繼承自 CIM_ResourceAllocationSettingData。

AllocationUnits

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

Reservation和Limit屬性所使用的配置單位。此屬性繼承自 CIM_ResourceAllocationSettingData。

AutomaticAllocation

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

指出是否會自動設定資源。此屬性繼承自 CIM_ResourceAllocationSettingData。

AutomaticDeallocation

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

指出資源是否會自動解除配置。此屬性繼承自 CIM_ResourceAllocationSettingData。

標題

資料類型：字串
存取類型：唯讀
限定詞： MaxLen (64)

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

[連接]

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

此資源所連接的裝置。此屬性繼承自 CIM_ResourceAllocationSettingData。

這是唯讀屬性，但如果 1) ResourceType屬性為 17 (序列埠) ，或 2) ResourceType屬性為 21 (Storage Extent) ，且ResourceSubType屬性為「Microsoft Virtual Hard Disk」，則可以使用Msvm_VirtualSystemManagementService類別的ModifyResourceSettings方法來變更。

ConsumerVisibility

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

取用者對已配置資源的可見度。此屬性繼承自 CIM_ResourceAllocationSettingData。

說明

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

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

ElementName

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

物件的顯示名稱。此屬性繼承自 CIM_SettingData。變更這個屬性將會變更相關聯邏輯裝置衍生專案的專案名稱。

HostResource

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

只有一個主機資源可以指派給虛擬機器中的每個裝置，因此只能設定此陣列的第一個專案。對於支援此功能的裝置，請將 HostResource 陣列的第一個專案設定為包含要指派之基礎主機資源的參考。此屬性繼承自 CIM_ResourceAllocationSettingData。

InstanceID

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

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

限制

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

虛擬機器可取用的對應主機資源數量上限。此屬性繼承自 CIM_ResourceAllocationSettingData。

MappingBehavior

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

指定此資源如何對應至基礎資源。此屬性繼承自 CIM_ResourceAllocationSettingData。

MaximumMonitors

資料類型： uint8
存取類型：讀取/寫入

3D 顯示器控制器可用的監視器數目上限。監視器數目下限為 1，最大值取決於螢幕解析度上限。下表定義允許用於不同解析度的監視器數目上限。

解決方案	監視器數目上限
1024 768	4
1280 1024	4
1600 1200	3
1920 1200	2

MaximumScreenResolution

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

指定 3D 顯示控制器的最大螢幕解析度。這必須是下列其中一個值。

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 的值為 1 (Other) 。此屬性繼承自 CIM_ResourceAllocationSettingData。

父系

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

資源的父代。此屬性繼承自 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 類別

語法

成員

屬性

規格需求

意見反應

其他資源