CIM_DiskDrive 类 (CIMWin32 WMI 提供程序)
CIM_DiskDrive 类表示操作系统所看到的物理磁盘驱动器。 磁盘驱动器功能对应于驱动器的逻辑和管理特征，在某些情况下，可能无法反映设备的物理特征。 物理驱动器的接口是此类的成员。 但是，基于另一个逻辑设备的对象不是此类的成员。
重要
DMTF (分布式管理任务组) CIM (Common Information Model) 类是生成 WMI 类的父类。 WMI 目前仅支持 CIM 2.x 版本架构。
以下语法从托管对象格式 (MOF) 代码简化而来，包括所有继承属性。 属性按字母顺序列出，而不是按 MOF 顺序列出。
语法
[Abstract, UUID("{8502C52C-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class CIM_DiskDrive : CIM_MediaAccessDevice
{
uint16 Availability;
uint16 Capabilities[];
string CapabilityDescriptions[];
string Caption;
string CompressionMethod;
uint32 ConfigManagerErrorCode;
boolean ConfigManagerUserConfig;
string CreationClassName;
uint64 DefaultBlockSize;
string Description;
string DeviceID;
boolean ErrorCleared;
string ErrorDescription;
string ErrorMethodology;
datetime InstallDate;
uint32 LastErrorCode;
uint64 MaxBlockSize;
uint64 MaxMediaSize;
uint64 MinBlockSize;
string Name;
boolean NeedsCleaning;
uint32 NumberOfMediaSupported;
string PNPDeviceID;
uint16 PowerManagementCapabilities[];
boolean PowerManagementSupported;
string Status;
uint16 StatusInfo;
string SystemCreationClassName;
string SystemName;
};
成员
CIM_DiskDrive 类具有以下类型的成员：
方法
CIM_DiskDrive 类具有以下方法。
| 方法 | 说明 |
|---|---|
| 重 置 | 请求重置逻辑设备。 未由 WMI 实现。 |
| SetPowerState | 定义逻辑设备的所需电源状态，以及设备何时应进入该状态。 未由 WMI 实现。 |
属性
CIM_DiskDrive 类具有以下属性。
-
可用性
-
-
数据类型： 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)
-
磁盘驱动器不可用。
功能
-
数据类型： uint16 数组
-
访问类型：只读
-
限定符： ArrayType (“Indexed”) ， MappingStrings (“MIF。DMTF |Storage Devices|001.9“， ”MIF.DMTF |存储设备|001.11“，”MIF。DMTF |存储设备|001.12“，”MIF。DMTF |Disks|003.7“) ， ModelCorrespondence (”CIM_MediaAccessDevice。CapabilityDescriptions“)
媒体访问设备的功能。 此属性继承自 CIM_MediaAccessDevice。
未知 (0)
未知。
其他 (1)
其他。
顺序访问 (2)
顺序访问。
随机访问 (3)
随机访问。
支持写入 (4)
编写。
加密 (5)
加密。
压缩 (6)
压缩。
支持可移除媒体 (7)
可移动介质。
手动清理 (8)
手动清洁。
自动清洁 (9)
自动清理。
SMART Notification (10)
SMART 通知。
支持双面媒体 (11)
区分可从仅读取单面且需要翻转媒体的设备中访问双面媒体的两侧的设备。
不需要预卸载弹出 (12)
指示在被选取器元素访问之前，不必从设备显式弹出媒体。
CapabilityDescriptions
-
数据类型： 字符串 数组
-
访问类型：只读
-
限定符： ArrayType (“Indexed”) ， ModelCorrespondence (“CIM_MediaAccessDevice。功能“)
自由格式字符串数组，提供 功能 数组中指示的访问设备功能的详细说明。 此属性继承自 CIM_MediaAccessDevice。
注意
此数组的每个条目都与位于同一索引的 Capabilities 数组中的条目相关。
Caption
-
数据类型： 字符串
-
访问类型：只读
-
限定符： MaxLen (64) 、 DisplayName (“Caption”)
对象的简短文本说明。
此属性继承自 CIM_ManagedSystemElement。
CompressionMethod
-
数据类型： 字符串
-
访问类型：只读
自由格式字符串，指示用于压缩逻辑文件的算法或工具。 如果压缩方案未知或未描述，请使用“未知”。 如果逻辑文件已压缩，但压缩方案未知或未描述，请使用“Compressed”。 如果逻辑文件未压缩，请使用“未压缩”。
此属性继承自 CIM_MediaAccessDevice。
(“未知”)
压缩方案未知或未描述。
(“Compressed”)
逻辑文件已压缩，但压缩方案未知或未描述
(“未压缩”)
如果逻辑文件未压缩
ConfigManagerErrorCode
-
数据类型： uint32
-
访问类型：只读
-
限定符： 架构 (“Win32”)
Windows Configuration Manager错误代码。
此属性继承自 CIM_LogicalDevice。
此设备工作正常。 (0)
设备工作正常。
此设备配置不正确。 (1)
设备配置不正确。
Windows 无法加载此设备的驱动程序。 (2)
此设备的驱动程序可能已损坏，或者系统的内存或其他资源可能运行不足。 (3)
此设备的驱动程序可能已损坏，或者系统内存或其他资源可能不足。
此设备无法正常工作。其中一个驱动程序或注册表可能已损坏。 (4)
设备无法正常工作。 其中一个驱动程序或注册表可能已损坏。
此设备的驱动程序需要 Windows 无法管理的资源。 (5)
设备的驱动程序需要 Windows 无法管理的资源。
此设备的启动配置与其他设备冲突。 (6)
设备的启动配置与其他设备冲突。
无法筛选。 (7)
缺少设备的驱动程序加载程序。 (8)
缺少设备的驱动程序加载程序。
此设备无法正常工作，因为控制固件错误地报告设备的资源。 (9)
设备无法正常工作;控制固件错误地报告了设备的资源。
此设备无法启动。 (10)
设备无法启动。
此设备失败。 (11)
设备失败。
此设备找不到可以使用的足够可用资源。 (12)
设备找不到足够的可用资源来使用。
Windows 无法验证此设备的资源。 (13)
Windows 无法验证设备的资源。
在重启计算机之前，此设备无法正常工作。 (14)
在重启计算机之前，设备无法正常工作。
此设备无法正常工作，因为可能存在重新枚举问题。 (15)
设备由于可能的重新枚举问题而无法正常工作。
Windows 无法识别此设备使用的所有资源。 (16)
Windows 无法识别设备使用的所有资源。
此设备请求未知资源类型。 (17)
设备正在请求未知资源类型。
重新安装此设备的驱动程序。 (18)
必须重新安装设备驱动程序。
使用 VxD 加载程序失败。 (19)
注册表可能已损坏。 (20)
注册表可能已损坏。
系统故障：尝试更改此设备的驱动程序。如果这不起作用，请参阅硬件文档。Windows 正在删除此设备。 (21)
系统故障。 如果更改设备驱动程序无效，请参阅硬件文档。 Windows 正在删除设备。
此设备已禁用。 (22)
设备已禁用。
系统故障：尝试更改此设备的驱动程序。如果这不起作用，请参阅硬件文档。 (23)
系统故障。 如果更改设备驱动程序无效，请参阅硬件文档。
此设备不存在、工作不正常或未安装其所有驱动程序。 (24)
设备不存在、工作不正常或未安装其所有驱动程序。
Windows 仍在设置此设备。 (25)
Windows 仍在设置设备。
Windows 仍在设置此设备。 (26)
Windows 仍在设置设备。
此设备没有有效的日志配置。 (27)
设备没有有效的日志配置。
未安装此设备的驱动程序。 (28)
未安装设备驱动程序。
此设备处于禁用状态，因为设备的固件未为其提供所需的资源。 (29)
设备已禁用;设备固件未提供所需的资源。
此设备使用另一个设备正在使用的中断请求 (IRQ) 资源。 (30)
设备正在使用另一个设备正在使用的 IRQ 资源。
此设备无法正常工作，因为 Windows 无法加载此设备所需的驱动程序。 (31)
设备无法正常工作;Windows 无法加载所需的设备驱动程序。
ConfigManagerUserConfig
-
数据类型： 布尔值
-
访问类型：只读
-
限定符： 架构 (“Win32”)
如果 为 TRUE，则设备正在使用用户定义的配置。
此属性继承自 CIM_LogicalDevice。
CreationClassName
-
数据类型： string
-
访问类型：只读
-
限定符： CIM_Key
创建实例时使用的类 (或子类) 的名称。 与 类的其他键属性一起使用时，此属性允许唯一标识类及其子类的所有实例。
此属性继承自 CIM_LogicalDevice。
DefaultBlockSize
-
数据类型： uint64
-
访问类型：只读
-
限定符： 单位 (“字节”)
设备的默认块大小（以字节为单位）。
此属性继承自 CIM_MediaAccessDevice。
有关在脚本中使用 uint64 值的详细信息，请参阅 WMI 中的脚本。
描述
-
数据类型： string
-
访问类型：只读
-
限定符： DisplayName (“Description”)
对象的文本说明。
此属性继承自 CIM_ManagedSystemElement。
DeviceID
-
数据类型： string
-
访问类型：只读
-
限定符： CIM_Key
用于唯一命名逻辑设备的地址或其他标识信息。
此属性继承自 CIM_LogicalDevice。
ErrorCleared
-
数据类型： 布尔值
-
访问类型：只读
如果 为 TRUE，则清除 LastErrorCode 属性中报告的错误。
此属性继承自 CIM_LogicalDevice。
ErrorDescription
-
数据类型： string
-
访问类型：只读
自由格式字符串，提供有关 LastErrorCode 属性中记录的错误和要执行的纠正操作的信息。
此属性继承自 CIM_LogicalDevice。
ErrorMethodology
-
数据类型： string
-
访问类型：只读
描述设备支持的错误检测和更正类型的自由格式字符串。
此属性继承自 CIM_MediaAccessDevice。
InstallDate
-
数据类型： datetime
-
访问类型：只读
-
限定符： MappingStrings (“MIF”。DMTF |ComponentID|001.5“) ， DisplayName (”安装日期“)
对象的安装日期和时间。 此属性不需要值来指示已安装对象。
此属性继承自 CIM_ManagedSystemElement。
LastErrorCode
-
数据类型： uint32
-
访问类型：只读
逻辑设备报告的最后一个错误代码。
此属性继承自 CIM_LogicalDevice。
MaxBlockSize
-
数据类型： uint64
-
访问类型：只读
-
限定符： 单位 (“字节”)
设备访问的媒体的最大块大小（以字节为单位）。
此属性继承自 CIM_MediaAccessDevice。
有关在脚本中使用 uint64 值的详细信息，请参阅 WMI 中的脚本。
MaxMediaSize
-
数据类型： uint64
-
访问类型：只读
-
限定符： MappingStrings (“MIF”。DMTF |顺序访问设备|001.2“) ， 单位 (”千字节“)
设备支持的媒体的最大大小（以 KB 为单位）。 千字节解释为字节数乘以 1000 (而不是字节数乘以 1024) 。
此属性继承自 CIM_MediaAccessDevice。
有关在脚本中使用 uint64 值的详细信息，请参阅 WMI 中的脚本。
MinBlockSize
-
数据类型： uint64
-
访问类型：只读
-
限定符： 单位 (“字节”)
设备访问的媒体的最小块大小（以字节为单位）。
此属性继承自 CIM_MediaAccessDevice。
有关在脚本中使用 uint64 值的详细信息，请参阅 WMI 中的脚本。
名称
-
数据类型： string
-
访问类型：只读
-
限定符： DisplayName (“Name”)
对象的已知标签。 当子类化时，此属性可以重写为键属性。
此属性继承自 CIM_ManagedSystemElement。
NeedsCleaning
-
数据类型： 布尔值
-
访问类型：只读
如果 为 TRUE，则媒体访问设备需要清理。 功能数组属性中指示了手动清理还是自动清理。
此属性继承自 CIM_MediaAccessDevice。
NumberOfMediaSupported
-
数据类型： uint32
-
访问类型：只读
当媒体访问设备支持多个单独的媒体时，此属性定义可支持或插入的最大数量。
此属性继承自 CIM_MediaAccessDevice。
PNPDeviceID
-
数据类型： 字符串
-
访问类型：只读
-
限定符： 架构 (“Win32”)
Windows 即插即用逻辑设备的设备标识符。
此属性继承自 CIM_LogicalDevice。
示例：“*PNP030b”
PowerManagementCapabilities
-
数据类型： uint16 数组
-
访问类型：只读
逻辑设备的特定电源相关功能。
此属性继承自 CIM_LogicalDevice。
未知 (0)
未知。
不支持 (1)
不支持。
禁用 (2)
已禁用。
已启用 (3)
电源管理功能当前已启用，但确切功能集未知或信息不可用。
自动进入节能模式 (4)
设备可以根据使用或其他条件更改其电源状态。
Power State Settable (5)
支持 SetPowerState 方法。
支持电源循环 (6)
可以将 PowerState 参数设置为 5 (“Power Cycle”) 调用 SetPowerState 方法。
支持计时开机 (7)
可以使用 PowerState 参数设置为 5 (“Power Cycle”) 调用 SetPowerState 方法，并将时间参数设置为开机的特定日期和时间或间隔。
PowerManagementSupported
-
数据类型： 布尔值
-
访问类型：只读
如果 为 TRUE，则可以对设备进行电源管理，即进入省电状态。 如果 为 False，则整数值 1 (“Not Supported”) 应为 PowerManagementCapabilities 数组中的唯一条目。
此属性不指示当前是否已启用电源管理功能，如果已启用，则支持哪些功能。 有关详细信息，请参阅 PowerManagementCapabilities 数组。 此属性继承自 CIM_LogicalDevice。
Status
-
数据类型： 字符串
-
访问类型：只读
-
限定符： MaxLen (10) 、 DisplayName (“Status”)
对象的当前状态。
此属性继承自 CIM_ManagedSystemElement。
包括以下值：
OK (“OK”)
错误 (“错误”)
降级 (“已降级”)
未知 (“未知”)
Pred Fail (“Pred Fail”)
starting (“Starting”)
停止 (“停止”)
服务 (“服务”)
压力 (“有压力”)
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
界定系统的 CreationClassName 属性的范围。
此属性继承自 CIM_LogicalDevice。
SystemName
-
数据类型： 字符串
-
访问类型：只读
-
限定符： 传播 (“CIM_System。Name“) ， CIM_Key
界定系统的 Name 属性的范围。
此属性继承自 CIM_LogicalDevice。
备注
CIM_DiskDrive 类派生自 CIM_MediaAccessDevice。
WMI 不实现此类。 有关派生自 CIM_DiskDrive 的类，请参阅 Win32 类。
本文档派生自 DMTF 发布的 CIM 类说明。 Microsoft 可能已对更正小错误、符合 Microsoft SDK 文档标准或提供详细信息进行了更改。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows Vista |
| 最低受支持的服务器 |
Windows Server 2008 |
| 命名空间 |
Root\CIMV2 |
| MOF |
|
| DLL |
|
另请参阅
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈