Partager via


Msvm_Synthetic3DDisplayControllerSettingData classe

Représente les paramètres d’un contrôleur d’affichage 3D synthétique pour une machine virtuelle. Cette classe est utilisée uniquement avec les machines virtuelles qui utilisent RemoteFX.

La syntaxe suivante est un code MOF (Managed Object Format) simplifié et inclut toutes les propriétés héritées.

Syntaxe

[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;
};

Membres

La classe Msvm_Synthetic3DDisplayControllerSettingData comporte les types de membres suivants :

Propriétés

La classe Msvm_Synthetic3DDisplayControllerSettingData a ces propriétés.

Adresse

Type de données : chaîne

Type d'accès : Lecture seule

Adresse de la ressource. Cette propriété est héritée de CIM_ResourceAllocationSettingData.

Il s’agit d’une propriété en lecture seule, mais si la propriété ResourceType a la valeur 20 (contrôleur Graphics), elle peut être modifiée à l’aide de la méthode ModifyResourceSettings de la classe Msvm_VirtualSystemManagementService .

AddressOnParent

Type de données : chaîne

Type d'accès : Lecture seule

Décrit l’adresse de cette ressource dans le contexte du parent. Les propriétés Parent et AddressOnParent sont utilisées pour décrire la relation de contrôleur ainsi que l’ordre des appareils sur un contrôleur. Cette propriété est héritée de CIM_ResourceAllocationSettingData.

AllocationUnits

Type de données : chaîne

Type d'accès : Lecture seule

Unités d’allocation utilisées par les propriétés Reservation et Limit . Cette propriété est héritée de CIM_ResourceAllocationSettingData.

AutomaticAllocation

Type de données : booléen

Type d'accès : Lecture seule

Indique si la ressource sera automatiquement allouée. Cette propriété est héritée de CIM_ResourceAllocationSettingData.

AutomaticDeallocation

Type de données : booléen

Type d'accès : Lecture seule

Indique si la ressource sera automatiquement libérée. Cette propriété est héritée de CIM_ResourceAllocationSettingData.

Caption

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (64)

Brève description de l’objet. Cette propriété est héritée de CIM_ManagedElement.

Connection

Type de données : tableau de chaînes

Type d'accès : Lecture seule

Appareil auquel cette ressource est connectée. Cette propriété est héritée de CIM_ResourceAllocationSettingData.

Il s’agit d’une propriété en lecture seule, mais si 1) la propriété ResourceType a la valeur 17 (port série) ou 2) la propriété ResourceType a la valeur 21 (Extension de stockage) et la propriété ResourceSubType est « Microsoft Virtual Hard Disk », elle peut être modifiée à l’aide de la méthode ModifyResourceSettings de la classe Msvm_VirtualSystemManagementService .

ConsumerVisibility

Type de données : uint16

Type d'accès : Lecture seule

Visibilité du consommateur sur la ressource allouée. Cette propriété est héritée de CIM_ResourceAllocationSettingData.

Description

Type de données : chaîne

Type d'accès : Lecture seule

Description de l'objet . Cette propriété est héritée de CIM_ManagedElement.

ElementName

Type de données : chaîne

Type d'accès : Lecture seule

Nom complet de l’objet. Cette propriété est héritée de CIM_SettingData. La modification de cette propriété modifie le nom de l’élément dérivé de l’appareil logique associé.

HostResource

Type de données : tableau de chaînes

Type d'accès : Lecture seule

Une seule ressource hôte peut être affectée à chaque appareil de la machine virtuelle, de sorte que seul le premier élément de ce tableau peut être défini. Pour les appareils qui prennent en charge cette fonctionnalité, définissez le premier élément du tableau HostResource pour qu’il contienne une référence à la ressource hôte sous-jacente qui doit être affectée. Cette propriété est héritée de CIM_ResourceAllocationSettingData.

InstanceID

Type de données : chaîne

Type d'accès : Lecture seule

Identifie de manière unique un instance de cette classe. Cette propriété est héritée de CIM_ManagedElement.

Limite

Type de données : uint64

Type d'accès : Lecture seule

Quantité maximale de ressources hôtes correspondantes qui peuvent être consommées par la machine virtuelle. Cette propriété est héritée de CIM_ResourceAllocationSettingData.

MappingBehavior

Type de données : uint16

Type d'accès : Lecture seule

Spécifie la façon dont cette ressource est mappée aux ressources sous-jacentes. Cette propriété est héritée de CIM_ResourceAllocationSettingData.

MaximumMonitors

Type de données : uint8

Type d’accès : Lecture/écriture

Nombre maximal de moniteurs disponibles pour le contrôleur d’affichage 3D. Le nombre minimal de moniteurs est de 1 et le nombre maximal dépend de la résolution d’écran maximale. Le tableau suivant définit le nombre maximal de moniteurs autorisés pour différentes résolutions.

Résolution Nombre maximal de moniteurs
1024 768
4
1280 1024
4
1600 1200
3
1920 1200
2

MaximumScreenResolution

Type de données : uint8

Type d'accès : Lecture seule

Spécifie la résolution d’écran maximale pour le contrôleur d’affichage 3D. Il doit s’agir de l’une des valeurs suivantes.

1024 * 768 (0)

La résolution maximale est 1024 768.

1280 * 1024 (1)

La résolution maximale est 1280 1024.

1600 * 1200 (2)

La résolution maximale est 1600 1200.

1920 * 1200 (3)

La résolution maximale est 1920 1200.

2560 * 1600 (4)

La résolution maximale est 2650 1600.

3840 * 2160 (5)

La résolution maximale est 3840 2160.

Notes

Ajout dans Windows 10 et Windows Server 2016.msvm_synte

OtherResourceType

Type de données : chaîne

Type d'accès : Lecture seule

Chaîne qui décrit le type de ressource lorsqu’une valeur bien définie n’est pas disponible et que ResourceType a la valeur 1(Other). Cette propriété est héritée de CIM_ResourceAllocationSettingData.

Parent

Type de données : chaîne

Type d'accès : Lecture seule

Parent de la ressource. Cette propriété est héritée de CIM_ResourceAllocationSettingData.

PoolID

Type de données : chaîne

Type d'accès : Lecture seule

Identificateur du pool de ressources à partir duquel cette ressource a été allouée. Cette propriété est héritée de CIM_ResourceAllocationSettingData.

Réservation

Type de données : uint64

Type d'accès : Lecture seule

Quantité de ressources processeur réservées à l’utilisation par la machine virtuelle. Ces ressources sont garanties pour être utilisées par la machine virtuelle. Cette propriété est héritée de CIM_ResourceAllocationSettingData.

ResourceSubType

Type de données : chaîne

Type d'accès : Lecture seule

Chaîne qui décrit un sous-type spécifique à l’implémentation pour cette ressource. Par exemple, cela peut être utilisé pour distinguer différents modèles du même type de ressource. Cette propriété est héritée de CIM_ResourceAllocationSettingData.

ResourceType

Type de données : uint16

Type d'accès : Lecture seule

Type de ressource que représente ce paramètre d’allocation. Cette propriété est héritée de CIM_ResourceAllocationSettingData.

VirtualQuantity

Type de données : uint64

Type d'accès : Lecture seule

Nombre total de cœurs dans la machine virtuelle. Cette propriété est héritée de CIM_ResourceAllocationSettingData.

VirtualQuantityUnits

Type de données : chaîne

Type d'accès : Lecture seule

Spécifie l’unité de mesure de la propriété VirtualQuantity . La valeur de cette propriété doit être une valeur légale du qualificateur d’unités programmatiques tel que défini dans l’annexe C.1 de DSP0004 V2.5 ou version ultérieure. Cette propriété est héritée de CIM_ResourceAllocationSettingData.

VRAMSizeBytes

Type de données : uint64

Type d’accès : Lecture/écriture

Taille de la mémoire vidéo pour la machine virtuelle.

Notes

Ajout dans Windows 10 et Windows Server 2016.

(67108864)

(134217728)

(268435456)

(536870912)

(1073741824)

Poids

Type de données : uint32

Type d'accès : Lecture seule

Entier qui définit le poids pour chaque processeur de machine virtuelle. Une fois toutes les réserves remplies, la capacité de processeur physique restante de la plateforme d’hébergement sera allouée aux machines virtuelles en fonction de leur pondération relative. Cette propriété est héritée de CIM_ResourceAllocationSettingData.

0

Plage : 0 1000

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server 2012 [applications de bureau uniquement]
Espace de noms
Racine\Virtualisation\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe