CIM_Memory class (Hyper-V management)

  • Article

Represents the capabilities and management of memory-related logical devices.

Syntax

[Abstract, Version("2.8.0"), UMLPackagePath("CIM::Device::Memory"), AMENDMENT]
class CIM_Memory : CIM_StorageExtent
{
  boolean  Volatile;
  string   ErrorMethodology;
  uint64   StartingAddress;
  uint64   EndingAddress;
  uint16   ErrorInfo;
  string   OtherErrorDescription;
  boolean  CorrectableError;
  datetime ErrorTime;
  uint16   ErrorAccess;
  uint32   ErrorTransferSize;
  uint8    ErrorData[];
  uint16   ErrorDataOrder;
  uint64   ErrorAddress;
  boolean  SystemLevelAddress;
  uint64   ErrorResolution;
  uint8    AdditionalErrorData[];
};

Members

The CIM_Memory class has these types of members:

Properties

The CIM_Memory class has these properties.

AdditionalErrorData

Data type: uint8 array

Access type: Read-only

Qualifiers: Deprecated ("CIM_MemoryError.AdditionalErrorData"), OctetString, MappingStrings ("MIF.DMTF|Memory Device|005.18", "MIF.DMTF|Physical Memory Array|001.13")

An array of octets that contains additional error information. An example is ECC syndrome or the return of the check bits if a CRC-based error methodology is used. In the latter case, if a single bit error is recognized and the CRC algorithm is known, it is possible to determine the exact bit that failed.

If the ErrorInfo property contains "3" (OK), this property is not used.

CorrectableError

Data type: boolean

Access type: Read-only

Qualifiers: Deprecated ("CIM_MemoryError.CorrectableError"), MappingStrings ("MIF.DMTF|Physical Memory Array|001.8")

true if the most recent error is correctable; otherwise, false. If the ErrorInfo property contains "3" (OK), this property is not used.

EndingAddress

Data type: uint64

Access type: Read-only

Qualifiers: Units ("KiloBytes"), MappingStrings ("MIF.DMTF|Memory Array Mapped Addresses|001.4", "MIF.DMTF|Memory Device Mapped Addresses|001.5"), PUnit ("byte * 10^3")

The ending address that is referenced by an application or operating system, and mapped by a memory controller for the memory object. The ending address is specified in kilobytes.

ErrorAccess

Data type: uint16

Access type: Read-only

Qualifiers: Deprecated ("CIM_MemoryError.ErrorAccess"), MappingStrings ("MIF.DMTF|Physical Memory Array|001.10")

The memory access operation that caused the last error. If the ErrorInfo property contains "3" (OK), this property is not used.

Other (1)

Unknown (2)

Read (3)

Write (4)

Partial Write (5)

ErrorAddress

Data type: uint64

Access type: Read-only

Qualifiers: Deprecated ("CIM_MemoryError.StartingAddress"), MappingStrings ("MIF.DMTF|Memory Device|005.19", "MIF.DMTF|Physical Memory Array|001.14")

The address of the last memory error. The type of error is described by the ErrorInfo property. If the ErrorInfo property contains "3" (OK), this property is not used.

ErrorData

Data type: uint8 array

Access type: Read-only

Qualifiers: Deprecated ("CIM_MemoryError.ErrorData"), OctetString, ArrayType ("Indexed"), MappingStrings ("MIF.DMTF|Physical Memory Array|001.12")

An array that contains data captured during the last erroneous memory access. The data occupies the first n octets of the array necessary to hold the number of bits specified by the ErrorTransferSize property.

If the ErrorTransferSize property contains "0" (OK), this property is not used.

ErrorDataOrder

Data type: uint16

Access type: Read-only

Qualifiers: Deprecated ("CIM_MemoryError.ErrorDataOrder")

The ordering for data stored in the ErrorData property. "Least Significant Byte First" (value=1) or "Most Significant Byte First" (2) can be specified. If the ErrorTransferSize property contains "0" (OK), this property is not used.

Unknown (0)

Least Significant Byte First (1)

Most Significant Byte First (2)

ErrorInfo

Data type: uint16

Access type: Read-only

Qualifiers: Deprecated ("CIM_MemoryError.ErrorInfo"), MappingStrings ("MIF.DMTF|Memory Device|005.12", "MIF.DMTF|Physical Memory Array|001.8"), ModelCorrespondence ("CIM_Memory.OtherErrorDescription")

The type of the last error to occur.

Other (1)

Unknown (2)

OK (3)

Bad Read (4)

Parity Error (5)

Single-Bit Error (6)

Double-Bit Error (7)

Multi-Bit Error (8)

Nibble Error (9)

Checksum Error (10)

CRC Error (11)

Undefined (12)

Undefined (13)

Undefined (14)

ErrorMethodology

Data type: string

Access type: Read-only

Qualifiers: Override ("ErrorMethodology"), MappingStrings ("MIF.DMTF|Physical Memory Array|001.7")

Indicates whether parity algorithms, CRC algorithms, ECC, or other mechanisms are used by the memory object. Details on the algorithm can also be supplied.

ErrorResolution

Data type: uint64

Access type: Read-only

Qualifiers: Deprecated ("CIM_MemoryError.ErrorResolution"), Units ("Bytes"), MappingStrings ("MIF.DMTF|Memory Device|005.21", "MIF.DMTF|Physical Memory Array|001.15"), PUnit ("byte")

The range, in bytes, in which the last error can be resolved. For example, if error addresses are resolved to bit 11, such as on a typical page basis; then the errors can be resolved to 4K boundaries, and this property is set to "4000". If the ErrorInfo property contains "3" (OK), this property is not used.

ErrorTime

Data type: datetime

Access type: Read-only

Qualifiers: Deprecated ("CIM_MemoryError.ErrorTime")

The time when the last memory error occurred. If the ErrorInfo property contains "3" (OK), this property is not used.

ErrorTransferSize

Data type: uint32

Access type: Read-only

Qualifiers: Deprecated ("CIM_MemoryError.ErrorTransferSize"), Units ("Bits"), MappingStrings ("MIF.DMTF|Physical Memory Array|001.11"), PUnit ("bit")

The size of the data transfer, in bits, that caused the last error. "0" indicates no error. If the ErrorInfo property contains "3" (OK), this property is not used.

OtherErrorDescription

Data type: string

Access type: Read-only

Qualifiers: Deprecated ("CIM_MemoryError.OtherErrorDescription"), ModelCorrespondence ("CIM_Memory.ErrorInfo")

A description of the error type, when the ErrorType property is set to "1" (other).

StartingAddress

Data type: uint64

Access type: Read-only

Qualifiers: Units ("KiloBytes"), MappingStrings ("MIF.DMTF|Memory Array Mapped Addresses|001.3", "MIF.DMTF|Memory Device Mapped Addresses|001.4"), PUnit ("byte * 10^3")

The starting address that is referenced by an application or operating system, and mapped by a memory controller for the memory object. The starting address is specified in kilobytes.

SystemLevelAddress

Data type: boolean

Access type: Read-only

Qualifiers: Deprecated ("CIM_MemoryError.SystemLevelAddress")

true if the address information in the ErrorAddress property is a system-level address, false if it is a physical address.

Volatile

Data type: boolean

Access type: Read-only

true if the memory is volatile; otherwise, false.

Requirements

Requirement Value
Minimum supported client
 Windows 8
Minimum supported server
 Windows Server 2012
Namespace
 Root\virtualization\v2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

See also

CIM_StorageExtent