Msvm_Synthetic3DDisplayControllerSettingData 클래스

아티클
06/12/2023

가상 머신의 가상 3D 디스플레이 컨트롤러에 대한 설정을 나타냅니다. 이 클래스는 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 클래스에는 이러한 속성이 있습니다.

주소

데이터 형식: 문자열
액세스 형식: 읽기 전용

리소스의 주소입니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.

읽기 전용 속성이지만 ResourceType 속성이 20(그래픽 컨트롤러)인 경우 Msvm_VirtualSystemManagementService 클래스의 ModifyResourceSettings 메서드를 사용하여 변경할 수 있습니다.

AddressOnParent

데이터 형식: 문자열
액세스 형식: 읽기 전용

부모 컨텍스트에서 이 리소스의 주소를 설명합니다. Parent 및 AddressOnParent 속성은 컨트롤러 관계 및 컨트롤러의 디바이스 순서를 설명하는 데 사용됩니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.

AllocationUnits

데이터 형식: 문자열
액세스 형식: 읽기 전용

예약 및 제한 속성에서 사용하는 할당 단위입니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.

AutomaticAllocation

데이터 형식: boolean
액세스 형식: 읽기 전용

리소스가 자동으로 할당되는지 여부를 나타냅니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.

AutomaticDeallocation

데이터 형식: boolean
액세스 형식: 읽기 전용

리소스의 할당이 자동으로 취소되는지 여부를 나타냅니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.

캡션

데이터 형식: string
액세스 형식: 읽기 전용
한정자: MaxLen(64)

개체에 대한 간단한 설명입니다. 이 속성은 CIM_ManagedElement 상속됩니다.

연결

데이터 형식: 문자열 배열
액세스 형식: 읽기 전용

이 리소스가 연결된 디바이스입니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.

읽기 전용 속성이지만 1) ResourceType 속성이 17(직렬 포트) 또는 2) ResourceType 속성이 21(스토리지 익스텐트)이고 ResourceSubType 속성이 "Microsoft 가상 하드 디스크"인 경우 Msvm_VirtualSystemManagementService 클래스의 ModifyResourceSettings 메서드를 사용하여 변경할 수 있습니다.

ConsumerVisibility

데이터 형식: uint16
액세스 형식: 읽기 전용

할당된 리소스에 대한 소비자의 가시성입니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.

설명

데이터 형식: 문자열
액세스 형식: 읽기 전용

개체에 대한 설명입니다. 이 속성은 CIM_ManagedElement 상속됩니다.

ElementName

데이터 형식: 문자열
액세스 형식: 읽기 전용

개체의 표시 이름입니다. 이 속성은 CIM_SettingData 상속됩니다. 이 속성을 변경하면 연결된 논리 디바이스 파생의 요소 이름이 변경됩니다.

HostResource

데이터 형식: 문자열 배열
액세스 형식: 읽기 전용

가상 머신의 각 디바이스에 하나의 호스트 리소스만 할당할 수 있으므로 이 배열의 첫 번째 요소만 설정할 수 있습니다. 이 기능을 지원하는 디바이스의 경우 할당할 기본 호스트 리소스에 대한 참조를 포함하도록 HostResource 배열의 첫 번째 요소를 설정합니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.

InstanceID

데이터 형식: 문자열
액세스 형식: 읽기 전용

이 클래스의 instance 고유하게 식별합니다. 이 속성은 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(기타)인 경우 리소스 형식을 설명하는 문자열입니다. 이 속성은 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
액세스 형식: 읽기/쓰기

Virtual Machine의 비디오 메모리 크기입니다.

참고

Windows 10 및 Windows Server 2016 추가되었습니다.

(67108864)

(134217728)

(268435456)

(536870912)

(1073741824)

가중치

데이터 형식: uint32
액세스 형식: 읽기 전용

각 가상 머신 프로세서의 가중치를 정의하는 정수입니다. 모든 예약이 충족되면 호스팅 플랫폼의 나머지 물리적 프로세서 용량은 상대 가중치에 따라 가상 머신에 할당됩니다. 이 속성은 CIM_ResourceAllocationSettingData 상속됩니다.

범위: 0 1000

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
네임스페이스	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

다음을 통해 공유

Msvm_Synthetic3DDisplayControllerSettingData 클래스

구문

멤버

속성

요구 사항

피드백

추가 리소스