Msvm_Synth3dVideoPool class

Article
01/07/2021

Contains information about the synthetic 3-D video graphics processing units (GPUs) available on the host system. This class is only used with host systems that support RemoteFX.

The following syntax is simplified Managed Object Format (MOF) code, and it includes all of the inherited properties.

Syntax

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

Members

The Msvm_Synth3dVideoPool class has these types of members:

Methods
Properties

Methods

The Msvm_Synth3dVideoPool class has these methods.

Method	Description
CalculateVideoMemoryRequirements	Calculates the amount of video memory required for a RemoteFX virtual machine.

Properties

The Msvm_Synth3dVideoPool class has these properties.

AllocationUnits

Data type: string
Access type: Read-only

The units of allocation used by the resource pool. This property is inherited from CIM_ResourcePool.

Capacity

Data type: uint64
Access type: Read-only

The maximum amount (in units of AllocationUnits) of active reservations that the resource pool can support. This property is inherited from CIM_ResourcePool.

Caption

Data type: string
Access type: Read-only
Qualifiers: MaxLen (64)

A short description of the object. This property is inherited from CIM_ManagedElement.

CommunicationStatus

Data type: uint16
Access type: Read-only

Indicates the ability of the instrumentation to communicate with the underlying managed element. A Null value indicates that this property is not implemented. This property is inherited from CIM_ManagedSystemElement.

Unknown (0)
Not Available (1)
Communication OK (2)
Lost Communication (3)
No Contact (4)
DMTF Reserved (..)
Vendor Reserved (0x8000.. )

ConsumedResourceUnits

Data type: string
Access type: Read-only

Specifies the units for the MaxConsumableResource and the CurrentlyConsumedResource properties. This property is inherited from CIM_ResourcePool.

CurrentlyConsumedResource

Data type: uint64
Access type: Read-only

Specifies the amount of resource that the resource pool currently presents to consumers. This property is different from the Reserved property in that it describes the consumers view of the resource, while the Reserved property describes the producers view of the resource. This property is inherited from CIM_ResourcePool.

Description

Data type: string
Access type: Read-only

A description of the object. This property is inherited from CIM_ManagedElement.

DetailedStatus

Data type: uint16
Access type: Read-only

Compliments the PrimaryStatus property with additional status detail. A Null value indicates that this property is not implemented. This property is inherited from CIM_ManagedSystemElement.

Not Available (0)
No Additional Information (1)
Stressed (2)
Predictive Failure (3)
Non-Recoverable Error (4)
Supporting Entity in Error (5)
DMTF Reserved (..)
Vendor Reserved (0x8000.. )

DirectXVersion

Data type: string
Access type: Read-only
Qualifiers: MAXLEN (1024)

Specifies the lowest version of DirectX that is supported by the cards within the resource pool.

ElementName

Data type: string
Access type: Read-only

A display name for the object. This property allows each instance to define a display name in addition to its key properties, identity data, and description information. The Name property of the CIM_ManagedSystemElement class is also defined as a display name, but it is often subclassed to be a Key. It is not reasonable that the same property can convey both identity and a display name, without inconsistencies. Where Name exists and is not a Key (such as for instances of LogicalDevice), the same information can be present in both the Name and ElementName properties. This property is inherited from CIM_ManagedElement.

HealthState

Data type: uint16
Access type: Read-only

The current health of the element. This property is inherited from CIM_ManagedSystemElement, and it is always set to 5 (OK).

InstallDate

Data type: datetime
Access type: Read-only

The date and time at which the virtual machine was created. This property is inherited from CIM_ManagedSystemElement.

InstanceID

Data type: string
Access type: Read-only
Qualifiers: Key

Uniquely identifies an instance of this class. This property is inherited from CIM_ManagedElement.

Is3dVideoSupported

Data type: boolean
Access type: Read-only

Specifies whether 3-D video is supported by the host system. Contains a nonzero value if 3-D video is supported, or zero otherwise. To support 3-D video, the RemoteFX host must have second level address translation (SLAT) capabilities and have at least one physical GPU that supports RemoteFX.

IsGPUCapable

Data type: boolean
Access type: Read-only

Specifies whether the host has GPUs that support RemoteFX and whether their DirectX versions meet the minimum requirement.

IsSLATCapable

Data type: boolean
Access type: Read-only
Qualifiers: Deprecated ("No value")

Specifies whether the host has a second level address translation (SLAT) capable CPU.

Note

Deprecated in Windows 10, version 1703 and Windows Server 2016.

MaxConsumableResource

Data type: uint64
Access type: Read-only

Specifies the maximum amount of consumable resource that the resource pool can present to consumers. This property is different from the Capacity property in that it describes the consumers view of the resource, while the Capacity property describes the producers view of the resource. This property is inherited from CIM_ResourcePool.

Name

Data type: string
Access type: Read-only
Qualifiers: MaxLen (1024)

The label by which the object is known. When subclassed, this property can be overridden to be a key property. This property is inherited from CIM_ManagedSystemElement.

OperatingStatus

Data type: uint16
Access type: Read-only

Provides current status information for the operational condition of the element and can be used for providing more detail with respect to the value of the EnabledState property. A Null value indicates that this property is not implemented. This property is inherited from CIM_ManagedSystemElement.

Unknown (0)
Not Available (1)
Servicing (2)
Starting (3)
Stopping (4)
Stopped (5)
Aborted (6)
Dormant (7)
Completed (8)
Migrating (9)
Emigrating (10)
Immigrating (11)
Snapshotting (12)
Shutting Down (13)
In Test (14)
Transitioning (15)
In Service (16)
DMTF Reserved (..)
Vendor Reserved (0x8000.. )

OperationalStatus

Data type: uint16 array
Access type: Read-only

The current status of the element. This property is inherited from CIM_ManagedSystemElement, and it is always set to 2 (OK). Hyper-V will only ever use the first element of this array.

OtherResourceType

Data type: string
Access type: Read-only

A string that describes the resource type when a well-defined value is not available and ResourceType is set to 0 ("Other"). This property is inherited from CIM_ResourcePool, and it is set to Null.

PoolID

Data type: string
Access type: Read-only

This value is referenced by the CIM_ResourceAllocationSettingData instances which were allocated from this pool. This property is inherited from CIM_ResourcePool, and it is always set to "Microsoft:GUID\Root".

PrimaryStatus

Data type: uint16
Access type: Read-only

Provides high level status information. This property should be used in conjunction with the DetailedStatus property to provide high level and detailed health status of the element and its subcomponents. A Null value indicates that this property is not implemented. This property is inherited from CIM_ManagedSystemElement.

Unknown (0)
OK (1)
Degraded (2)
Error (3)
DMTF Reserved (..)
Vendor Reserved (0x8000.. )

Primordial

Data type: boolean
Access type: Read-only

True if this resource pool is the base from which resources are drawn and returned in the activity of resource management; otherwise, False. Being primordial means that this resource pool cannot be created or deleted by consumers of this model. However, other actions, modeled or not, may affect the characteristics or size of primordial resource pools. This property is inherited from CIM_ResourcePool.

RequiredMinimumDirectXVersion

Data type: string
Access type: Read-only
Qualifiers: MAXLEN (1024)

Specifies the lowest version of DirectX that is required by the cards within the resource pool.

Reserved

Data type: uint64
Access type: Read-only

The current reservations (in units of AllocationUnits) spread across all active allocations from this pool. In a hierarchical configuration, this represents the sum of all descendant resource pool current reservations. This property is inherited from CIM_ResourcePool.

ResourceSubType

Data type: string
Access type: Read-only

A string that describes an implementation specific subtype for this pool. For example, this may be used to distinguish different models of the same resource type. This property is inherited from CIM_ResourcePool.

ResourceType

Data type: uint16
Access type: Read-only

The type of resource this resource pool can allocate. This property is inherited from CIM_ResourcePool, and it is always set to 4 ("Memory").

Status

Data type: string
Access type: Read-only

This property is inherited from CIM_ManagedSystemElement, but it is not used.

StatusDescriptions

Data type: string array
Access type: Read-only

Strings that describe the various OperationalStatus array values. This property is inherited from CIM_ManagedSystemElement, and it is always set to "OK". Hyper-V will only ever use the first element of this array.

Requirements

Requirement	Value
Minimum supported client	Windows 8 [desktop apps only]
Minimum supported server	Windows Server 2012 [desktop apps only]
Namespace	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Share via