Compartilhar via

Classe Msvm_Synthetic3DDisplayControllerSettingData

  • Artigo

Representa as configurações de um controlador de exibição 3D sintético para uma máquina virtual. Essa classe só é usada com máquinas virtuais que usam RemoteFX.

A sintaxe a seguir é um código MOF (Managed Object Format) simplificado e inclui todas as propriedades herdadas.

Sintaxe

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

Membros

A classe Msvm_Synthetic3DDisplayControllerSettingData tem estes tipos de membros:

Propriedades

A classe Msvm_Synthetic3DDisplayControllerSettingData tem essas propriedades.

Endereço

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O endereço do recurso. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

Essa é uma propriedade somente leitura, mas se a propriedade ResourceType for 20 (controlador gráfico), ela poderá ser alterada usando o método ModifyResourceSettings da classe Msvm_VirtualSystemManagementService .

AddressOnParent

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Descreve o endereço desse recurso no contexto do pai. As propriedades Parent e AddressOnParent são usadas para descrever a relação do controlador, bem como a ordenação de dispositivos em um controlador. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

AllocationUnits

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

As unidades de alocação usadas pelas propriedades Reservation e Limit . Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

AutomaticAllocation

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Indica se o recurso será alocado automaticamente. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

AutomaticDeallocation

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Indica se o recurso será desalocado automaticamente. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

Legenda

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (64)

Uma breve descrição do objeto. Essa propriedade é herdada de CIM_ManagedElement.

Conexão

Tipo de dados: matriz de cadeia de caracteres

Tipo de acesso: Somente leitura

O dispositivo ao qual esse recurso está conectado. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

Essa é uma propriedade somente leitura, mas se 1) a propriedade ResourceType for 17 (porta serial) ou 2) a propriedade ResourceType for 21 (Extensão de Armazenamento) e a propriedade ResourceSubType for "Disco Rígido Virtual da Microsoft", ela poderá ser alterada usando o método ModifyResourceSettings da classe Msvm_VirtualSystemManagementService .

ConsumerVisibility

Tipo de dados: uint16

Tipo de acesso: Somente leitura

A visibilidade do consumidor para o recurso alocado. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

Descrição

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Uma descrição do objeto . Essa propriedade é herdada de CIM_ManagedElement.

ElementName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Um nome de exibição para o objeto . Essa propriedade é herdada de CIM_SettingData. Alterar essa propriedade alterará o nome do elemento do derivado do dispositivo lógico associado.

HostResource

Tipo de dados: matriz de cadeia de caracteres

Tipo de acesso: Somente leitura

Somente um recurso de host pode ser atribuído a cada dispositivo na máquina virtual, portanto, somente o primeiro elemento dessa matriz pode ser definido. Para dispositivos que dão suporte a esse recurso, defina o primeiro elemento da matriz HostResource para conter uma referência ao recurso de host subjacente a ser atribuído. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

InstanceID

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Identifica exclusivamente uma instância dessa classe. Essa propriedade é herdada de CIM_ManagedElement.

Limite

Tipo de dados: uint64

Tipo de acesso: Somente leitura

A quantidade máxima de recursos de host correspondentes que podem ser consumidos pela máquina virtual. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

MappingBehavior

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Especifica como esse recurso é mapeado para recursos subjacentes. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

MaximumMonitors

Tipo de dados: uint8

Tipo de acesso: leitura/gravação

O número máximo de monitores disponíveis para o controlador de exibição 3D. O número mínimo de monitores é 1 e o máximo depende da resolução máxima da tela. A tabela a seguir define o número máximo de monitores permitidos para resoluções diferentes.

Resolução Máximo de monitores
1024 768
 4
1280 1024
 4
1600 1200
 3
1920 1200
 2

MaximumScreenResolution

Tipo de dados: uint8

Tipo de acesso: Somente leitura

Especifica a resolução máxima de tela para o controlador de exibição 3D. Esse deve ser um dos valores a seguir.

1024 * 768 (0)

A resolução máxima é 1024 768.

1280 * 1024 (1)

A resolução máxima é 1280 1024.

1600 * 1200 (2)

A resolução máxima é 1600 1200.

1920 * 1200 (3)

A resolução máxima é 1920 1200.

2560 * 1600 (4)

A resolução máxima é 2650 1600.

3840 * 2160 (5)

A resolução máxima é 3840 2160.

Observação

Adicionado em Windows 10 e Windows Server 2016.msvm_synte

OtherResourceType

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Uma cadeia de caracteres que descreve o tipo de recurso quando um valor bem definido não está disponível e ResourceType tem o valor 1(Outro). Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

Pai

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O pai do recurso. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

PoolID

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O identificador do pool de recursos do qual esse recurso foi alocado. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

Reserva

Tipo de dados: uint64

Tipo de acesso: Somente leitura

A quantidade de recursos de CPU reservados para uso pela máquina virtual. Esses recursos têm a garantia de estar disponíveis para consumo pela máquina virtual. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

ResourceSubType

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Uma cadeia de caracteres que descreve um subtipo específico de implementação para esse recurso. Por exemplo, isso pode ser usado para distinguir diferentes modelos do mesmo tipo de recurso. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

ResourceType

Tipo de dados: uint16

Tipo de acesso: Somente leitura

O tipo de recurso que essa configuração de alocação representa. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

VirtualQuantity

Tipo de dados: uint64

Tipo de acesso: Somente leitura

O número total de núcleos na máquina virtual. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

VirtualQuantityUnits

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Especifica a unidade de medida para a propriedade VirtualQuantity . O valor dessa propriedade deve ser um valor legal do qualificador de Unidades Programáticas, conforme definido no Anexo C.1 de DSP0004 V2.5 ou posterior. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

VRAMSizeBytes

Tipo de dados: uint64

Tipo de acesso: leitura/gravação

O tamanho da memória do vídeo para a Máquina Virtual.

Observação

Adicionado em Windows 10 e Windows Server 2016.

(67108864)

(134217728)

(268435456)

(536870912)

(1073741824)

Weight

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Um inteiro que define o peso de cada processador de máquina virtual. Depois que todas as reservas forem atendidas, a capacidade restante do processador físico da plataforma de hospedagem será alocada para máquinas virtuais com base em seus pesos relativos. Essa propriedade é herdada de CIM_ResourceAllocationSettingData.

0

Intervalo: 0 1000

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
 Windows Server 2012 [somente aplicativos da área de trabalho]
Namespace
 Root\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe