CIM_Memory類別 (CIMWin32 WMI 提供者)

發行項
06/13/2023

CIM_Memory類別代表記憶體相關邏輯裝置的功能和管理。

重要

DMTF (Distributed Management Task Force) 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 摘要、檢查位或同位資料，或其他廠商提供的資訊) 。如果 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 (一個) 。

如需在腳本中使用 uint64 值的詳細資訊，請參閱 WMI 中的腳本。

此屬性繼承自 CIM_StorageExtent。

標題

資料類型：字串
存取類型：唯讀
限定詞： 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。

EndingAddress

資料類型： uint64
存取類型：唯讀
限定詞： MappingStrings (「MIF。DMTF|記憶體陣列對應位址|001.4「，」MIF.DMTF|記憶體裝置對應位址|001.5「) ，單位 (」KB「)

應用程式或作業系統所參考的結束位址，並由這個記憶體物件的記憶體控制器對應。結束位址是以 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「)

最近發生的錯誤類型。 CIM 架構中未定義 12 到 14 的值，因為 DMI 會混合錯誤類型的語意，以及其是否可更正。 更正錯誤是否可在 CorrectableError屬性中指出。

其他 (1)

其他。

未知的 (2)

未知。

確定 (3)

正常。

錯誤的讀取 (4)

讀取錯誤。

同位錯誤 (5)

同位錯誤。

單一位錯誤 (6)

單一位錯誤。

雙位錯誤 (7)

雙位錯誤。

多位錯誤 (8)

多位錯誤。

Nibble 錯誤 (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「) ，單位 (」bytes「)

指定可以解析最後一個錯誤的範圍，以位元組為單位。例如，如果錯誤位址解析為位 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「) ，單位 (」bits「)

造成最後一個錯誤的資料傳輸大小，以位為單位。值為 0 表示沒有錯誤。如果 ErrorInfo 屬性等於 3 (「OK」) ，則此屬性應該設定為 0。

InstallDate

資料類型： datetime
存取類型：唯讀
限定詞： MappingStrings (「MIF。DMTF|ComponentID|001.5「) ， DisplayName (」Install Date「)

指出何時安裝物件。缺少值並不表示未安裝物件。

此屬性繼承自 CIM_ManagedSystemElement。

LastErrorCode

資料類型： uint32
存取類型：唯讀

邏輯裝置回報的最後一個錯誤碼。

此屬性繼承自 CIM_LogicalDevice。

名稱

資料類型：字串
存取類型：唯讀
限定詞： DisplayName (「Name」)

已知物件的標籤。子類別化時，這個屬性可以覆寫為索引鍵屬性。

此屬性繼承自 CIM_ManagedSystemElement。

NumberOfBlocks

資料類型： uint64
存取類型：唯讀
限定詞： MappingStrings (「MIB。IETF|HOST-RESOURCES-MIB.hrStorageSize「)

連續區塊的數目，每個區塊的大小都包含在 BlockSize 屬性中，形成儲存範圍。儲存範圍的大小總計可以藉由將 BlockSize 屬性的值乘以這個屬性的值來計算。如果 BlockSize 的值是 1 (一個) ，則此屬性是儲存體範圍的總計大小。

如需在腳本中使用 uint64 值的詳細資訊，請參閱 WMI 中的腳本。

此屬性繼承自 CIM_StorageExtent。

OtherErrorDescription

資料類型：字串
存取類型：唯讀
限定詞： ModelCorrespondence (「CIM_Memory。ErrorInfo「)

如果 ErrorType 屬性設定為 1 (「Other」) ，則提供資訊的免費格式字串。如果未設定為 1，則此字串沒有意義。

PNPDeviceID

資料類型：字串
存取類型：唯讀
限定詞：架構 (「Win32」)

指出邏輯裝置的 Win32 隨插即用裝置識別碼。

範例：「*PNP030b」

此屬性繼承自 CIM_LogicalDevice。

PowerManagementCapabilities

資料類型： uint16 陣列
存取類型：唯讀

指出邏輯裝置的特定電源相關功能。

此屬性繼承自 CIM_LogicalDevice。

未知 (0)

電源相關的容量未知。

不支援 (1)

此裝置不支援與電源相關的容量。

已停用 (2)

電源相關容量已停用。

已啟用 (3)

電源管理功能目前已啟用，但確切的功能集未知或資訊無法使用。

自動輸入的省電模式 (4)

裝置可以根據使用量或其他準則來變更其電源狀態。

Power State Settable (5)

支援 SetPowerState 方法。這個方法位於父 CIM_LogicalDevice 類別上，而且可以實作。如需詳細資訊，請參閱設計 Managed 物件格式 (MOF) 類別。

支援 (6) 的電源迴圈

您可以使用PowerState參數設定為 5 (「Power Cycle」) 來叫用SetPowerState方法。

支援的計時電源 (7)

您可以使用PowerState參數設定為 5 (「Power Cycle」) 叫用SetPowerState方法，並將Time參數設定為特定日期和時間或開啟電源的間隔。

PowerManagementSupported

資料類型： 布林值
存取類型：唯讀

如果 為 TRUE，則裝置可以電源管理，也就是進入省電狀態。如果 為 FALSE，則整數值 1 (「不支援」) 應該是 PowerManagementCapabilities 陣列中唯一的專案。

這個屬性不會指出電源管理功能目前是否已啟用，或者如果已啟用，則表示支援哪些功能。如需詳細資訊，請參閱 PowerManagementCapabilities 陣列。

此屬性繼承自 CIM_LogicalDevice。

目的

資料類型：字串
存取類型：唯讀

描述媒體及其使用方式的免費格式字串。

此屬性繼承自 CIM_StorageExtent。

StartingAddress

資料類型： uint64
存取類型：唯讀
限定詞： MappingStrings (「MIF。DMTF|記憶體陣列對應位址|001.3「，」MIF。DMTF|記憶體裝置對應位址|001.4「) ，單位 (」KB「)

此記憶體物件的起始位址，由應用程式或作業系統參考，並由記憶體控制器對應。起始位址是以 KB 為單位指定。

如需在腳本中使用 uint64 值的詳細資訊，請參閱 WMI 中的腳本。

狀態

資料類型：字串
存取類型：唯讀
限定詞： MaxLen (10) 、 DisplayName (「Status」)

表示物件目前狀態的字串。您可以定義作業和非操作狀態。作業狀態可以包括「OK」、「已降級」和「Pred Fail」。「預先失敗」表示元素正常運作，但正在預測失敗 (例如，已啟用 SMART 的硬碟) 。

非操作狀態可以包含「錯誤」、「啟動」、「停止」和「服務」。「服務」可以在磁片鏡像重新儲存期間套用、重載使用者許可權清單或其他系統管理工作。並非所有這類工作都處於線上狀態，但 Managed 元素不是「確定」，也不是在其他其中一種狀態。

此屬性繼承自 CIM_ManagedSystemElement。

包括下列值：

確定 (「確定」)

錯誤 (「錯誤」)

降級 (「降級」)

未知 (「未知」)

Pred Fail (「預先失敗」)

starting (「Starting」)

停止 (「停止」)

服務 (「Service」)

壓力 (「壓力」)

NonRecover (「NonRecover」)

無連絡人 (「無連絡人」)

Lost Comm (「Lost Comm」)

StatusInfo

資料類型： uint16
存取類型：唯讀
限定詞： MappingStrings (「MIF。DMTF|操作狀態|003.3「)

邏輯裝置的狀態。如果此屬性不適用於邏輯裝置，則應該使用值 5 (「不適用」) 。

此屬性繼承自 CIM_LogicalDevice。

其他 (1)

未知 (2)

已啟用 (3)

已停用 (4)

不適用 (5)

SystemCreationClassName

資料類型：字串
存取類型：唯讀
限定詞：傳播 (「CIM_System。CreationClassName「) ， CIM_Key

界定系統的建立類別名稱。

此屬性繼承自 CIM_LogicalDevice。

SystemLevelAddress

資料類型： 布林值
存取類型：唯讀

指出 ErrorAddress 屬性中的位址資訊是否為系統層級位址， (TRUE) 或實體位址 (FALSE) 。如果 ErrorInfo 屬性等於 3 (「OK」) ，則此屬性沒有任何意義。

SystemName

資料類型：字串
存取類型：唯讀
限定詞：傳播 (「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 提供者)

語法

成員

方法

屬性

備註

規格需求

另請參閱

意見反應

其他資源