Msvm_AllocationCapabilities class

Article
01/07/2021

Defines the means by which a client can discover the valid range of default settings for a virtual resource. A Msvm_AllocationCapabilities object is associated with each resource pool. Four Msvm_ResourceAllocationSettingData objects are associated with the Msvm_AllocationCapabilities object to describe the minimum, maximum, default, and incremental values for the given resource's allocation. Together, these classes describe the overall range of supported capabilities.

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_AllocationCapabilities : CIM_AllocationCapabilities
{
  string InstanceID;
  string Caption;
  string Description;
  string ElementName;
  uint16 ResourceType;
  string OtherResourceType;
  string ResourceSubType;
  uint16 RequestTypesSupported;
  uint16 SharingMode;
  uint16 SupportedAddStates[];
  uint16 SupportedRemoveStates[];
};

Members

The Msvm_AllocationCapabilities class has these types of members:

Properties

Properties

The Msvm_AllocationCapabilities class has these properties.

Caption

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

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

Description

Data type: string
Access type: Read-only

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

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 a logical device), the same information can be present in both the Name and ElementName properties. This property is inherited from CIM_ManagedElement.

InstanceID

Data type: string
Access type: Read-only

A unique identifier for this resource pool. This property is inherited from CIM_ManagedElement.

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 has the value "Other". This property is inherited from CIM_AllocationCapabilities.

RequestTypesSupported

Data type: uint16
Access type: Read-only

Indicates whether requesting a specific resource is supported. This property is inherited from CIM_AllocationCapabilities.

Value	Meaning
Unknown 0	Unknown
Specific 2	The request can include a request for a specific resource.
General 3	The request does not include a request for a specific resource.
Both 4	Both specific and general requests are supported.

ResourceSubType

Data type: string
Access type: Read-only

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

ResourceType

Data type: uint16
Access type: Read-only

The type of resource this allocation setting represents. This property is inherited from CIM_AllocationCapabilities.

Other (1)
Computer System (2)
Processor (3)
Memory (4)
IDE Controller (5)
Parallel SCSI HBA (6)
FC HBA (7)
iSCSI HBA (8)
IB HCA (9)
Ethernet Adapter (10)
Other Network Adapter (11)
I/O Slot (12)
I/O Device (13)
Floppy Drive (14)
CD Drive (15)
DVD drive (16)
Disk Drive (17)
Tape Drive (18)
Storage Extent (19)
Other Storage Device (20)
Serial port (21)
Parallel port (22)
USB Controller (23)
Graphics controller (24)
IEEE 1394 Controller (25)
Partitionable Unit (26)
Base Partitionable Unit (27)
Power (28)
Cooling Capacity (29)
Ethernet Switch Port (30)
Logical Disk (31)
Storage Volume (32)
Ethernet Connection (33)
DMTF reserved (..)
Vendor Reserved (0x8000..0xFFFF )

SharingMode

Data type: uint16
Access type: Read-only

Indicates how access to an underlying resource is granted. This property is inherited from CIM_AllocationCapabilities.

Value	Meaning
Unknown 0	Unknown
Dedicated 2	Exclusive access to an underlying resource.
Shared 3	Shared use of an underlying resource.

SupportedAddStates

Data type: uint16 array
Access type: Read-only

Indicates the states that the system to which the resource will be associated can be in when a new resource is created. This property is inherited from CIM_AllocationCapabilities.

Unknown (0)
Enabled (2)
Disabled (3)
Shutting Down (4)
Not Applicable (5)
Enabled but Offline (6)
In Test (7)
Deferred (8)
Quiesce (9)
Starting (10)
Paused (11)
Suspended (12)
DMTF Reserved (..)
Vendor Reserved (0x8000..0xFFFF )

SupportedRemoveStates

Data type: uint16 array
Access type: Read-only

Indicates the states that the system to which the resource is associated can be in when the resource is removed. This property is inherited from CIM_AllocationCapabilities.

Unknown (0)
Enabled (2)
Disabled (3)
Shutting Down (4)
Not Applicable (5)
Enabled but Offline (6)
In Test (7)
Deferred (8)
Quiesce (9)
Starting (10)
Paused (11)
Suspended (12)
DMTF Reserved (..)
Vendor Reserved (0x8000..0xFFFF )

Remarks

Access to the Msvm_AllocationCapabilities class might be restricted by UAC Filtering. For more information, see User Account Control and WMI.

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