Msvm_Synthetic3DDisplayControllerSettingData クラス

[アーティクル]
06/13/2023

仮想マシンの合成 3-D ディスプレイコントローラーの設定を表します。このクラスは、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 クラスには、次の種類のメンバーがあります。

Properties

プロパティ

Msvm_Synthetic3DDisplayControllerSettingData クラスには、これらのプロパティがあります。

アドレス

データ型: string
アクセスの種類: 読み取り専用

リソースのアドレス。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

これは読み取り専用プロパティですが、ResourceType プロパティが 20 (グラフィックスコントローラー) の場合は、Msvm_VirtualSystemManagementService クラスの ModifyResourceSettings メソッドを使用して変更できます。

AddressOnParent

データ型: string
アクセスの種類: 読み取り専用

親のコンテキストでのこのリソースのアドレスについて説明します。 Parent プロパティと AddressOnParent プロパティは、コントローラーの関係と、コントローラー上のデバイスの順序を記述するために使用されます。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

AllocationUnits

データ型: string
アクセスの種類: 読み取り専用

Reservation プロパティと Limit プロパティで使用される割り当ての単位。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

AutomaticAllocation

データ型: ブール値
アクセスの種類: 読み取り専用

リソースが自動的に割り当てられるかどうかを示します。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

AutomaticDeallocation

データ型: ブール値
アクセスの種類: 読み取り専用

リソースの割り当てが自動的に解除されるかどうかを示します。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

Caption

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen (64)

オブジェクトの簡単な説明。このプロパティは、 CIM_ManagedElementから継承されます。

接続

データ型: 文字列 配列
アクセスの種類: 読み取り専用

このリソースが接続されているデバイス。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

これは読み取り専用プロパティですが、1) ResourceType プロパティが 17 (シリアルポート)、または 2) ResourceType プロパティが 21 (ストレージエクステント) で、ResourceSubType プロパティが "Microsoft Virtual Hard Disk" である場合は、Msvm_VirtualSystemManagementService クラスの ModifyResourceSettings メソッドを使用して変更できます。

ConsumerVisibility

データ型: uint16
アクセスの種類: 読み取り専用

割り当てられたリソースに対するコンシューマーの可視性。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

説明

データ型: string
アクセスの種類: 読み取り専用

オブジェクトの説明。このプロパティは、 CIM_ManagedElementから継承されます。

ElementName

データ型: string
アクセスの種類: 読み取り専用

オブジェクトの表示名。このプロパティは、 CIM_SettingDataから継承されます。このプロパティを変更すると、関連付けられている論理デバイス派生物の要素名が変更されます。

HostResource

データ型: 文字列 配列
アクセスの種類: 読み取り専用

仮想マシン内の各デバイスに割り当てることができるホストリソースは 1 つだけであるため、この配列の最初の要素のみを設定できます。この機能をサポートするデバイスの場合は、 HostResource 配列の最初の要素に、割り当てられる基になるホストリソースへの参照が含まれるよう設定します。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

InstanceID

データ型: string
アクセスの種類: 読み取り専用

このクラスのインスタンスを一意に識別します。このプロパティは、 CIM_ManagedElementから継承されます。

制限

データ型: uint64
アクセスの種類: 読み取り専用

仮想マシンで使用できる対応するホストリソースの最大量。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

MappingBehavior

データ型: uint16
アクセスの種類: 読み取り専用

このリソースを基になるリソースにマップする方法を指定します。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

MaximumMonitors

データ型: uint8
アクセスの種類: 読み取り/書き込み

3-D ディスプレイコントローラーで使用できるモニターの最大数。モニターの最小数は 1 で、最大は最大画面解像度に依存します。次の表では、さまざまな解像度で許可されるモニターの最大数を定義します。

解決策	最大モニター数
1024 768	4
1280 1024	4
1600 1200	3
1920 1200	2

MaximumScreenResolution

データ型: uint8
アクセスの種類: 読み取り専用

3-D ディスプレイコントローラーの最大画面解像度を指定します。これは、次のいずれかの値である必要があります。

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

データ型: string
アクセスの種類: 読み取り専用

適切に定義された値が使用できなく、 ResourceType の値が 1(Other) の場合にリソースの種類を表す文字列。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

Parent

データ型: string
アクセスの種類: 読み取り専用

リソースの親。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

PoolID

データ型: string
アクセスの種類: 読み取り専用

このリソースが割り当てられたリソースプールの識別子。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

予約

データ型: uint64
アクセスの種類: 読み取り専用

仮想マシンで使用するために予約されている CPU リソースの量。これらのリソースは、仮想マシンで使用できる必要があります。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

ResourceSubType

データ型: string
アクセスの種類: 読み取り専用

このリソースの実装固有のサブタイプを表す文字列。たとえば、これは、同じリソースの種類の異なるモデルを区別するために使用できます。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

ResourceType

データ型: uint16
アクセスの種類: 読み取り専用

この割り当て設定が表すリソースの種類。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

VirtualQuantity

データ型: uint64
アクセスの種類: 読み取り専用

仮想マシン内のコアの合計数。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

VirtualQuantityUnits

データ型: string
アクセスの種類: 読み取り専用

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 クラス

構文

メンバー

プロパティ

要件

フィードバック

その他のリソース