CIM_Memory 类 (CIMWin32 WMI 提供程序)

项目
06/13/2023

CIM_Memory 类表示内存相关逻辑设备的功能和管理功能。

重要

DMTF (分布式管理任务组) CIM (Common Information Model) 类是生成 WMI 类的父类。 WMI 目前仅支持 CIM 2.x 版本架构。

以下语法从托管对象格式 (MOF) 代码简化而来，包括所有继承属性。属性按字母顺序列出，而不是按 MOF 顺序列出。

语法

[Abstract, UUID("{FAF76B64-798C-11D2-AAD1-006008C78BC7}"), AMENDMENT]
class CIM_Memory : CIM_StorageExtent
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  uint16   Availability;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   DeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  ErrorCleared;
  string   ErrorDescription;
  uint32   LastErrorCode;
  string   PNPDeviceID;
  boolean  PowerManagementSupported;
  uint16   StatusInfo;
  string   SystemCreationClassName;
  string   SystemName;
  uint16   Access;
  uint64   BlockSize;
  uint64   NumberOfBlocks;
  string   Purpose;
  string   ErrorMethodology;
  uint8    AdditionalErrorData[];
  boolean  CorrectableError;
  uint64   EndingAddress;
  uint16   ErrorAccess;
  uint64   ErrorAddress;
  uint8    ErrorData[];
  uint16   ErrorDataOrder;
  uint16   ErrorInfo;
  uint64   ErrorResolution;
  datetime ErrorTime;
  uint32   ErrorTransferSize;
  string   OtherErrorDescription;
  uint64   StartingAddress;
  boolean  SystemLevelAddress;
};

成员

CIM_Memory 类具有以下类型的成员：

方法
属性

方法

CIM_Memory 类具有这些方法。

方法	说明
重置	请求重置逻辑设备。未由 WMI 实现。
SetPowerState	定义逻辑设备的所需电源状态，以及设备何时应进入该状态。未由 WMI 实现。

属性

CIM_Memory 类具有这些属性。

访问

数据类型： uint16
访问类型：只读

描述媒体的读/写属性。

此属性继承自 CIM_StorageExtent。

未知 (0)

可读 (1)

可写 (2)

支持读/写 (3)

写入一次 (4)

AdditionalErrorData

数据类型： uint8 数组
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |内存设备|002.18“，”MIF。DMTF |物理内存阵列|001.13“) ， MAX (64)

保存其他错误信息的八进制数数组。例如，错误检查和更正 (ECC) 综合征，或使用基于 CRC 的错误方法返回检查位。在后一种情况下，如果识别出单位错误并且 CRC 算法已知，则可以确定失败的确切位。此字段中包含此类数据 (ECC Syndrome、检查位或奇偶校验位数据或其他供应商提供的信息) 。如果 ErrorInfo 属性等于 3 (“OK”) ，则此属性没有意义。

可用性

数据类型： uint16
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |操作状态|003.5“，”MIB。IETF |HOST-RESOURCES-MIB.hrDeviceStatus“)

设备的可用性和状态。

此属性继承自 CIM_LogicalDevice。

其他 (1)

未知 (2)

运行/全功率 (3)

警告 (4)

在测试 (5)

不适用 (6)

关机 (7)

下线 (8)

下班 (9)

降级 (10)

未安装 (11)

安装错误 (12)

节能 - 未知 (13)

已知设备处于节能模式，但其确切状态未知。

节能 - 低功耗模式 (14)

设备处于省电状态，但仍可正常运行，性能可能会下降。

节能 - 待机 (15)

设备无法正常工作，但可以快速通电。

Power Cycle (16)

节能 - 警告 (17)

设备处于警告状态，但也处于省电模式。

暂停 (18)

设备已暂停。

未就绪 (19)

设备未准备就绪。

未配置 (20)

设备未配置。

静止 (21)

设备安静。

BlockSize

数据类型： uint64
访问类型：只读
限定符： MappingStrings (“MIB”。IETF |HOST-RESOURCES-MIB.hrStorageAllocationUnits“) ， Units (”bytes“)

构成存储区的块的大小（以字节为单位）。如果块大小可变，则应指定最大块大小（以字节为单位）。如果块大小未知，或者块概念无效 (例如，对于聚合盘区、内存或逻辑磁盘) ，请输入 1 (1) 。

有关在脚本中使用 uint64 值的详细信息，请参阅 WMI 中的脚本。

此属性继承自 CIM_StorageExtent。

Caption

数据类型： string
访问类型：只读
限定符： MaxLen (64) 、 DisplayName (“Caption”)

对象的简短文本说明。

此属性继承自 CIM_ManagedSystemElement。

ConfigManagerErrorCode

数据类型： uint32
访问类型：只读
限定符：架构 (“Win32”)

Win32 Configuration Manager错误代码。

此属性继承自 CIM_LogicalDevice。

此设备工作正常。 (0)

此设备配置不正确。 (1)

Windows 无法加载此设备的驱动程序。 (2)

该设备的驱动程序可能已损坏，或者系统内存不足或其他资源不足。 (3)

此设备无法正常工作。其中一个驱动程序或注册表可能已损坏。 (4)

此设备的驱动程序需要 Windows 无法管理的资源。 (5)

此设备的启动配置与其他设备冲突。 (6)

无法筛选。 (7)

缺少设备的驱动程序加载程序。 (8)

此设备无法正常工作，因为控制固件错误地报告设备的资源。 (9)

该设备无法启动。 (10)

此设备失败。 (11)

该设备找不到足够可用资源。 (12)

Windows 无法验证此设备的资源。 (13)

重新启动计算机之前，该设备无法正常工作。 (14)

此设备无法正常工作，因为可能存在重新枚举问题。 (15)

Windows 无法识别该设备使用的所有资源。 (16)

此设备请求未知资源类型。 (17)

重新安装此设备的驱动程序。 (18)

使用 VxD 加载程序失败。 (19)

注册表可能已损坏。 (20)

系统故障：尝试更改此设备的驱动程序。如果这不起作用，请参阅硬件文档。 Windows 正在删除这个设备。 (21)

该设备已被禁用。 (22)

系统故障：尝试更改此设备的驱动程序。如果这不起作用，请参阅硬件文档。 (23)

该设备不存在、运行不正确、或者没有安装所有的驱动程序。 (24)

Windows 仍在设置此设备。 (25)

Windows 仍在设置此设备。 (26)

此设备没有有效的日志配置。 (27)

未安装该设备的驱动程序。 (28)

该设备已被禁用，原因是，设备的固件没有提供必需的资源。 (29)

此设备使用中断请求 (IRQ) 另一个设备正在使用的资源。 (30)

由于 Windows 无法加载这个设备所需的驱动程序，导致这个设备工作异常。 (31)

ConfigManagerUserConfig

数据类型： 布尔值
访问类型：只读
限定符：架构 (“Win32”)

如果 为 TRUE，则设备使用的是用户定义的配置。

此属性继承自 CIM_LogicalDevice。

CorrectableError

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |内存设备|002.12“，”MIF。DMTF |物理内存阵列|001.8“)

如果 为 TRUE，则为可更正的最新错误。如果 ErrorInfo 属性等于 3 (“OK”) ，则此属性没有任何意义。

CreationClassName

数据类型： 字符串
访问类型：只读
限定符： CIM_Key

创建实例时使用的类或子类的名称。与类的其他键属性一起使用时，此属性允许唯一标识类及其子类的所有实例。

此属性继承自 CIM_LogicalDevice。

描述

数据类型： 字符串
访问类型：只读
限定符： DisplayName (“Description”)

对象的文本说明。

此属性继承自 CIM_ManagedSystemElement。

DeviceID

数据类型： 字符串
访问类型：只读
限定符： CIM_Key

用于唯一命名逻辑设备的地址或其他标识信息。

此属性继承自 CIM_LogicalDevice。

EndAddress

数据类型： uint64
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |内存数组映射地址|001.4“，”MIF。DMTF |内存设备映射地址|001.5“) ，单位 (”千字节“)

由应用程序或操作系统引用并由内存控制器为此内存对象映射的结束地址。以 KB 为单位指定结束地址。

有关在脚本中使用 uint64 值的详细信息，请参阅在 WMI 中编写脚本。

ErrorAccess

数据类型： uint16
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |内存设备|002.15“，”MIF。DMTF |物理内存阵列|001.10“)

导致上一个错误的内存访问操作。 ErrorInfo 属性描述了错误类型。如果 ErrorInfo 属性等于 3 (“OK”) ，则此属性没有任何意义。

其他 (1)

未知 (2)

阅读 (3)

写入 (4)

部分写入 (5)

ErrorAddress

数据类型： uint64
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |内存设备|002.19“，”MIF。DMTF |内存设备|002.20“，”MIF。DMTF |物理内存阵列|001.14“)

上一个内存错误的地址。 ErrorInfo 属性描述了错误类型。如果 ErrorInfo 属性等于 3 (“OK”) ，则此属性没有任何意义。

有关在脚本中使用 uint64 值的详细信息，请参阅在 WMI 中编写脚本。

ErrorCleared

数据类型： 布尔值
访问类型：只读

如果 为 TRUE，则 现在清除 LastErrorCode 属性中报告的错误。

此属性继承自 CIM_LogicalDevice。

ErrorData

数据类型： uint8 数组
访问类型：只读
限定符： ArrayType (“Indexed”) ， MappingStrings (“MIF。DMTF |内存设备|002.17“，”MIF。DMTF |物理内存阵列|001.12“) ， MAX (64)

上次错误内存访问期间捕获的数据。数据占用数组的前 n 个 八位字节，这些八进制数是保存 ErrorTransferSize 属性指定的位数所必需的。如果 ErrorTransferSize 为 0，则此属性没有任何意义。

ErrorDataOrder

数据类型： uint16
访问类型：只读

ErrorData 属性中存储的数据的顺序。如果 ErrorTransferSize 为 0，则此属性没有任何意义。

未知 (0)

未知。

最小有效字节第一 (1)

最小有效字节优先。

最大有效字节第一 (2)

最重要的字节优先。

ErrorDescription

数据类型： 字符串
访问类型：只读

自由格式字符串，提供有关 LastErrorCode 属性中记录的错误和要执行的纠正操作的信息。

此属性继承自 CIM_LogicalDevice。

ErrorInfo

数据类型： uint16
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |内存设备|002.12“，”MIF。DMTF |物理内存阵列|001.8“) ， ModelCorrespondence (”CIM_Memory。OtherErrorDescription“)

最近发生的错误类型。值 12 到 14 在 CIM 架构中未定义，因为 DMI 混合了错误类型的语义以及它是否可更正。 CorrectableError 属性中指示错误是否可更正。

其他 (1)

其他。

未知 (2)

未知。

正常 (3)

没问题。

错误读取 (4)

阅读错误。

奇偶校验错误 (5)

奇偶校验错误。

单位错误 (6)

单位错误。

双位错误 (7)

双位错误。

多位错误 (8)

多位错误。

( 9)

Nibble 错误。

校验和错误 (10)

校验和错误。

CRC 错误 (11)

CRC 错误。

未定义 (12)

未定义。

未定义 (13)

未定义。

未定义 (14)

未定义。

ErrorMethodology

数据类型： 字符串
访问类型：只读
限定符：重写 (“ErrorMethodology”) ， MappingStrings (“MIF。DMTF |物理内存阵列|001.7“)

指示是否使用奇偶校验或 CRC 算法、ECC 或其他机制。还可以提供算法的详细信息。

ErrorResolution

数据类型： uint64
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |内存设备|002.21“，”MIF。DMTF |物理内存阵列|001.15“) ，单位 (”字节“)

指定最后一个错误可以解决到的范围（以字节为单位）。例如，如果错误地址解析为位 11 (即，在典型的页面) ，则可以将错误解析为 4 KB 边界，并将此属性设置为 4000。如果 ErrorInfo 属性等于 3 (“OK”) ，则此属性没有意义。

有关在脚本中使用 uint64 值的详细信息，请参阅 WMI 中的脚本。

ErrorTime

数据类型： datetime
访问类型：只读

发生上次内存错误的日期和时间。 ErrorInfo 属性描述了错误类型。如果 ErrorInfo 属性等于 3 (“OK”) ，则此属性没有意义。

ErrorTransferSize

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |内存设备|002.16“，”MIF。DMTF |物理内存阵列|001.11“) ，单位 (”位“)

导致上次错误的数据传输大小（以位为单位）。值为 0 表示没有错误。如果 ErrorInfo 属性等于 3 (“OK”) ，则此属性应设置为 0。

InstallDate

数据类型： datetime
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |ComponentID|001.5“) ， DisplayName (”安装日期“)

指示对象的安装时间。缺少值并不表示未安装对象。

此属性继承自 CIM_ManagedSystemElement。

LastErrorCode

数据类型： uint32
访问类型：只读

逻辑设备报告的最后一个错误代码。

此属性继承自 CIM_LogicalDevice。

名称

数据类型： string
访问类型：只读
限定符： DisplayName (“Name”)

对象的已知标签。当子类化时，此属性可以重写为键属性。

此属性继承自 CIM_ManagedSystemElement。

NumberOfBlocks

数据类型： uint64
访问类型：只读
限定符： MappingStrings (“MIB”。IETF |HOST-RESOURCES-MIB.hrStorageSize“)

连续块的数目，每个块构成存储区的 BlockSize 属性中包含的值的大小。存储区的总大小可以通过将 BlockSize 属性的值乘以此属性的值来计算。如果 BlockSize 的值为 1 (一) ，则此属性是存储区的总大小。

有关在脚本中使用 uint64 值的详细信息，请参阅 WMI 中的脚本。

此属性继承自 CIM_StorageExtent。

OtherErrorDescription

数据类型： string
访问类型：只读
限定符： ModelCorrespondence (“CIM_Memory。ErrorInfo“)

自由格式字符串，在 ErrorType 属性设置为 1 (“Other”) 时提供信息。如果未设置为 1，则此字符串没有意义。

PNPDeviceID

数据类型： string
访问类型：只读
限定符：架构 (“Win32”)

指示逻辑设备的 Win32 即插即用设备标识符。

示例：“*PNP030b”

此属性继承自 CIM_LogicalDevice。

PowerManagementCapabilities

数据类型： uint16 数组
访问类型：只读

指示逻辑设备与电源相关的特定功能。

此属性继承自 CIM_LogicalDevice。

未知 (0)

与电源相关的容量未知。

不支持 (1)

此设备不支持与电源相关的容量。

已禁用 (2)

与电源相关的容量已被禁用。

已启用 (3)

电源管理功能当前已启用，但确切的功能集未知或信息不可用。

自动输入的节能模式 (4)

设备可以根据使用情况或其他条件更改其电源状态。

电源状态可设置 (5)

支持 SetPowerState 方法。此方法在父 CIM_LogicalDevice 类上找到，并且可以实现。有关详细信息，请参阅设计托管对象格式 (MOF) 类。

支持的电源循环 (6)

可以将 PowerState 参数设置为 5 (“Power Cycle”) 调用 SetPowerState 方法。

支持定时开机 (7)

可以使用 PowerState 参数设置为 5 (“Power Cycle”) 并将 Time 参数设置为开机的特定日期和时间或间隔来调用 SetPowerState 方法。

PowerManagementSupported

数据类型： 布尔值
访问类型：只读

如果 为 TRUE，则可以对设备进行电源管理，即进入省电状态。如果 为 FALSE，则整数值 1 (“不支持”) 应为 PowerManagementCapabilities 数组中的唯一条目。

此属性不指示当前是否已启用电源管理功能，或者如果已启用，则支持哪些功能。有关详细信息，请参阅 PowerManagementCapabilities 数组。

此属性继承自 CIM_LogicalDevice。

用途

数据类型： string
访问类型：只读

描述媒体及其用途的自由格式字符串。

此属性继承自 CIM_StorageExtent。

StartingAddress

数据类型： uint64
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |内存数组映射地址|001.3“，”MIF。DMTF |内存设备映射地址|001.4“) ，单位 (”千字节“)

此内存对象的起始地址，由应用程序或操作系统引用并由内存控制器映射。起始地址以 KB 为单位指定。

有关在脚本中使用 uint64 值的详细信息，请参阅 WMI 中的脚本。

Status

数据类型： string
访问类型：只读
限定符： MaxLen (10) 、 DisplayName (“Status”)

指示对象的当前状态的字符串。可以定义操作状态和非操作状态。操作状态可能包括“正常”、“已降级”和“预失败”。 “Pred Fail”表示元素正常运行，但预测故障 (例如启用 SMART 的硬盘驱动器) 。

非操作状态可能包括“错误”、“正在启动”、“正在停止”和“服务”。 “服务”可以在磁盘镜像重新同步、重新加载用户权限列表或其他管理工作期间应用。并非所有此类工作都处于联机状态，但托管元素既不是“正常”，也不是处于其他状态之一。

此属性继承自 CIM_ManagedSystemElement。

包括以下值：

OK (“OK”)

错误 (“错误”)

已降级 (“已降级”)

未知 (“未知”)

Pred Fail (“Pred Fail”)

正在启动 (“正在启动”)

正在停止 (“停止”)

服务 (“Service”)

压力 (“有压力”)

NonRecover (“NonRecover”)

无联系人 (“无联系人”)

Lost Comm (“Lost Comm”)

StatusInfo

数据类型： uint16
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |操作状态|003.3“)

逻辑设备的状态。如果此属性不适用于逻辑设备，则应使用值 5 (“Not Applicable”) 。

此属性继承自 CIM_LogicalDevice。

其他 (1)

未知 (2)

已启用 (3)

已禁用 (4)

不适用 (5)

SystemCreationClassName

数据类型： string
访问类型：只读
限定符：传播 (“CIM_System。CreationClassName“) ， CIM_Key

范围系统的创建类名称。

此属性继承自 CIM_LogicalDevice。

SystemLevelAddress

数据类型： 布尔值
访问类型：只读

指示 ErrorAddress 属性中的地址信息是 (TRUE) 的系统级地址，还是 (FALSE) 的物理地址。如果 ErrorInfo 属性等于 3 (“OK”) ，则此属性没有意义。

SystemName

数据类型： string
访问类型：只读
限定符：传播 (“CIM_System。名称“) ， CIM_Key

范围系统的名称。

此属性继承自 CIM_LogicalDevice。

备注

CIM_Memory 类派生自 CIM_StorageExtent。

WMI 不实现此类。有关派生自 CIM_Memory 的类，请参阅 Win32 类。

本文档派生自 DMTF 发布的 CIM 类说明。 Microsoft 可能已做出更改以更正小错误、符合 Microsoft SDK 文档标准或提供详细信息。

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
命名空间	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

另请参阅

CIM_StorageExtent

通过

CIM_Memory 类 (CIMWin32 WMI 提供程序)

语法

成员

方法

属性

备注

要求

另请参阅

反馈

其他资源