classe Msvm_Synth3dVideoPool

Artigo
06/03/2023

Contém informações sobre as GPUs (unidades de processamento de vídeo) sintéticas 3D disponíveis no sistema host. Essa classe só é usada com sistemas de host que dão suporte a RemoteFX.

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

Sintaxe

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_Synth3dVideoPool : CIM_ResourcePool
{
  string   InstanceID;
  string   Caption = "3D Display Controller Resource Pool";
  string   Description = "Resource pool used to allocate synthetic 3D video controller resources to a virtual machine.";
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[];
  string   StatusDescriptions[] = {"OK"};
  string   Status;
  uint16   HealthState;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  string   PoolID;
  boolean  Primordial = True;
  uint64   Capacity;
  uint64   Reserved = 0;
  uint16   ResourceType;
  string   OtherResourceType;
  string   ResourceSubType = "Microsoft:Hyper-V:Synthetic 3D Display Controller";
  string   AllocationUnits = "count";
  string   ConsumedResourceUnits = "count";
  uint64   CurrentlyConsumedResource;
  uint64   MaxConsumableResource;
  boolean  Is3dVideoSupported;
  boolean  IsSLATCapable;
  boolean  IsGPUCapable;
  string   DirectXVersion;
  string   RequiredMinimumDirectXVersion;
};

Membros

A classe Msvm_Synth3dVideoPool tem estes tipos de membros:

Métodos
Propriedades

Métodos

A classe Msvm_Synth3dVideoPool tem esses métodos.

Método	Descrição
CalculateVideoMemoryRequirements	Calcula a quantidade de memória de vídeo necessária para uma máquina virtual RemoteFX.

Propriedades

A classe Msvm_Synth3dVideoPool tem essas propriedades.

AllocationUnits

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

As unidades de alocação usadas pelo pool de recursos. Essa propriedade é herdada de CIM_ResourcePool.

Capacidade

Tipo de dados: uint64
Tipo de acesso: Somente leitura

A quantidade máxima (em unidades de AllocationUnits) de reservas ativas que o pool de recursos pode dar suporte. Essa propriedade é herdada de CIM_ResourcePool.

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.

CommunicationStatus

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Indica a capacidade da instrumentação de se comunicar com o elemento gerenciado subjacente. Um valor Null indica que essa propriedade não está implementada. Essa propriedade é herdada de CIM_ManagedSystemElement.

Desconhecido (0)
Não disponível (1)
Comunicação OK (2)
Comunicação Perdida (3)
Sem Contato (4)
DMTF Reservado (..)
Fornecedor Reservado (0x8000.. )

ConsumedResourceUnits

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Especifica as unidades para as propriedades MaxConsumableResource e CurrentlyConsumedResource . Essa propriedade é herdada de CIM_ResourcePool.

CurrentlyConsumedResource

Tipo de dados: uint64
Tipo de acesso: Somente leitura

Especifica a quantidade de recurso que o pool de recursos apresenta atualmente aos consumidores. Essa propriedade é diferente da propriedade Reserved na qual descreve a exibição de consumidores do recurso, enquanto a propriedade Reserved descreve a exibição de produtores do recurso. Essa propriedade é herdada de CIM_ResourcePool.

Descrição

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

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

DetailedStatus

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Complementa a propriedade PrimaryStatus com detalhes adicionais de status. Um valor Null indica que essa propriedade não está implementada. Essa propriedade é herdada de CIM_ManagedSystemElement.

Não disponível (0)
Nenhuma informação adicional (1)
Estressado (2)
Falha preditiva (3)
Erro não recuperável (4)
Entidade de suporte em erro (5)
DMTF Reservado (..)
Fornecedor Reservado (0x8000.. )

DirectXVersion

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MAXLEN (1024)

Especifica a versão mais baixa do DirectX compatível com os cartões no pool de recursos.

ElementName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Um nome de exibição para o objeto . Essa propriedade permite que cada instância defina um nome de exibição além de suas principais propriedades, dados de identidade e informações de descrição. A propriedade Name da classe CIM_ManagedSystemElement também é definida como um nome de exibição, mas geralmente é subclasse para ser uma Chave. Não é razoável que a mesma propriedade possa transmitir identidade e um nome de exibição, sem inconsistências. Onde Name existe e não é uma chave (como para instâncias de LogicalDevice), as mesmas informações podem estar presentes nas propriedades Name e ElementName . Essa propriedade é herdada de CIM_ManagedElement.

HealthState

Tipo de dados: uint16
Tipo de acesso: Somente leitura

A integridade atual do elemento. Essa propriedade é herdada de CIM_ManagedSystemElement e é sempre definida como 5 (OK).

InstallDate

Tipo de dados: datetime
Tipo de acesso: Somente leitura

A data e a hora em que a máquina virtual foi criada. Essa propriedade é herdada de CIM_ManagedSystemElement.

InstanceID

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Chave

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

Is3dVideoSupported

Tipo de dados: booliano
Tipo de acesso: Somente leitura

Especifica se o vídeo 3D é compatível com o sistema host. Contém um valor diferente de zero se houver suporte para vídeo 3D ou zero caso contrário. Para dar suporte a vídeos 3D, o host RemoteFX deve ter recursos de SLAT (conversão de endereços de segundo nível) e ter pelo menos uma GPU física compatível com RemoteFX.

IsGPUCapable

Tipo de dados: booliano
Tipo de acesso: Somente leitura

Especifica se o host tem GPUs que dão suporte ao RemoteFX e se suas versões do DirectX atendem ao requisito mínimo.

IsSLATCapable

Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: preterido ("Sem valor")

Especifica se o host tem uma CPU compatível com SLAT (conversão de endereços de segundo nível).

Observação

Preterido em Windows 10, versão 1703 e Windows Server 2016.

MaxConsumableResource

Tipo de dados: uint64
Tipo de acesso: Somente leitura

Especifica a quantidade máxima de recursos consumíveis que o pool de recursos pode apresentar aos consumidores. Essa propriedade é diferente da propriedade Capacity , pois descreve a exibição de consumidores do recurso, enquanto a propriedade Capacity descreve a exibição de produtores do recurso. Essa propriedade é herdada de CIM_ResourcePool.

Nome

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MaxLen (1024)

O rótulo pelo qual o objeto é conhecido. Quando subclasse, essa propriedade pode ser substituída para ser uma propriedade de chave. Essa propriedade é herdada de CIM_ManagedSystemElement.

OperatingStatus

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Fornece informações de status atuais para a condição operacional do elemento e pode ser usado para fornecer mais detalhes em relação ao valor da propriedade EnabledState. Um valor Null indica que essa propriedade não está implementada. Essa propriedade é herdada de CIM_ManagedSystemElement.

Desconhecido (0)
Não disponível (1)
Manutenção (2)
Começando (3)
Parando (4)
Parado (5)
Anulado (6)
Dormente (7)
Concluído (8)
Migrando (9)
Emigrou (10)
Immigrating (11)
Instantâneo (12)
Desligar (13)
Em Teste (14)
Transição (15)
Em Serviço (16)
DMTF Reservado (..)
Fornecedor Reservado (0x8000.. )

OperationalStatus

Tipo de dados: matriz uint16
Tipo de acesso: Somente leitura

O status atual do elemento. Essa propriedade é herdada de CIM_ManagedSystemElement e é sempre definida como 2 (OK). O Hyper-V usará apenas o primeiro elemento dessa matriz.

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 é definido como 0 ("Outros"). Essa propriedade é herdada de CIM_ResourcePool e está definida como Null.

PoolID

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Esse valor é referenciado pelas instâncias CIM_ResourceAllocationSettingData que foram alocadas desse pool. Essa propriedade é herdada de CIM_ResourcePool e é sempre definida como "Microsoft:GUID\Root".

PrimaryStatus

Tipo de dados: uint16
Tipo de acesso: Somente leitura

Fornece informações de status de alto nível. Essa propriedade deve ser usada em conjunto com a propriedade DetailedStatus para fornecer status de integridade detalhadas e de alto nível do elemento e seus subcomponentes. Um valor Null indica que essa propriedade não está implementada. Essa propriedade é herdada de CIM_ManagedSystemElement.

Desconhecido (0)
OK (1)
Degradado (2)
Erro (3)
DMTF Reservado (..)
Fornecedor Reservado (0x8000.. )

Primordial

Tipo de dados: booliano
Tipo de acesso: Somente leitura

True se esse pool de recursos for a base da qual os recursos são desenhados e retornados na atividade de gerenciamento de recursos; caso contrário, False. Ser primordial significa que esse pool de recursos não pode ser criado ou excluído pelos consumidores desse modelo. No entanto, outras ações, modeladas ou não, podem afetar as características ou o tamanho dos pools de recursos primordiais. Essa propriedade é herdada de CIM_ResourcePool.

RequiredMinimumDirectXVersion

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MAXLEN (1024)

Especifica a versão mais baixa do DirectX exigida pelos cartões dentro do pool de recursos.

Reserved

Tipo de dados: uint64
Tipo de acesso: Somente leitura

As reservas atuais (em unidades de AllocationUnits) se espalham por todas as alocações ativas desse pool. Em uma configuração hierárquica, isso representa a soma de todas as reservas atuais do pool de recursos descendentes. Essa propriedade é herdada de CIM_ResourcePool.

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 pool. Por exemplo, isso pode ser usado para distinguir diferentes modelos do mesmo tipo de recurso. Essa propriedade é herdada de CIM_ResourcePool.

ResourceType

Tipo de dados: uint16
Tipo de acesso: Somente leitura

O tipo de recurso que esse pool de recursos pode alocar. Essa propriedade é herdada de CIM_ResourcePool e é sempre definida como 4 ("Memória").

Status

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Essa propriedade é herdada de CIM_ManagedSystemElement, mas não é usada.

StatusDescriptions

Tipo de dados: matriz de cadeia de caracteres
Tipo de acesso: Somente leitura

Cadeias de caracteres que descrevem os vários valores de matriz OperationalStatus . Essa propriedade é herdada de CIM_ManagedSystemElement e está sempre definida como "OK". O Hyper-V usará apenas o primeiro elemento dessa matriz.

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

Confira também

CIM_ResourcePool

Compartilhar via