Win32_CDROMDrive 类

项目
06/12/2023

Win32_CDROMDriveWMI 类表示运行 Windows 的计算机系统上的 CD-ROM 驱动器。

注意

请注意，驱动器的名称与分配给设备的逻辑驱动器号不对应。

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

语法

[Dynamic, Provider("CIMWin32"), UUID("{8502C4B3-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_CDROMDrive : CIM_CDROMDrive
{
  uint16   Availability;
  uint16   Capabilities[];
  string   CapabilityDescriptions[];
  string   Caption;
  string   CompressionMethod;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  uint64   DefaultBlockSize;
  string   Description;
  string   DeviceID;
  string   Drive;
  boolean  DriveIntegrity;
  boolean  ErrorCleared;
  string   ErrorDescription;
  string   ErrorMethodology;
  uint16   FileSystemFlags;
  uint32   FileSystemFlagsEx;
  string   Id;
  datetime InstallDate;
  uint32   LastErrorCode;
  string   Manufacturer;
  uint64   MaxBlockSize;
  uint32   MaximumComponentLength;
  uint64   MaxMediaSize;
  boolean  MediaLoaded;
  string   MediaType;
  string   MfrAssignedRevisionLevel;
  uint64   MinBlockSize;
  string   Name;
  boolean  NeedsCleaning;
  uint32   NumberOfMediaSupported;
  string   PNPDeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  string   RevisionLevel;
  uint32   SCSIBus;
  uint16   SCSILogicalUnit;
  uint16   SCSIPort;
  uint16   SCSITargetId;
  string   SerialNumber;
  uint64   Size;
  string   Status;
  uint16   StatusInfo;
  string   SystemCreationClassName;
  string   SystemName;
  real64   TransferRate;
  string   VolumeName;
  string   VolumeSerialNumber;
};

成员

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

方法
属性

方法

Win32_CDROMDrive 类具有这些方法。

方法	说明
重置	未实现。若要实现此方法，请参阅 CIM_CDROMDrive 中的 Reset 方法以获取文档。
SetPowerState	未实现。若要实现此方法，请参阅 CIM_CDROMDrive 中的 SetPowerState 方法以获取文档。

属性

Win32_CDROMDrive 类具有这些属性。

可用性

数据类型： 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“)

媒体访问设备的功能数组。例如，设备可能支持随机访问 (3) 、可移动媒体 (7) 和自动清洁 (9) 。

此属性继承自 CIM_MediaAccessDevice。

未知 (0)

其他 (1)

顺序访问 (2)

随机访问 (3)

支持写入 (4)

加密 (5)

压缩 (6)

支持可移除媒体 (7)

支持可移动媒体

手动清理 (8)

自动清洁 (9)

SMART Notification (10)

支持双面媒体 (11)

支持Dual-Sided媒体

不需要预卸载弹出 (12)

CapabilityDescriptions

数据类型： 字符串 数组
访问类型：只读
限定符： ArrayType (“Indexed”) ， ModelCorrespondence (“CIM_MediaAccessDevice。功能“)

功能数组中指示的任何访问设备功能的更详细说明数组。此数组的每个条目都与位于同一索引的 Capabilities 数组中的条目相关。

此属性继承自 CIM_MediaAccessDevice。

Caption

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

对象的简短说明为单行字符串。

此属性继承自 CIM_ManagedSystemElement。

CompressionMethod

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

设备用于支持压缩的算法或工具。如果不可能或不希望描述压缩方案 (可能是因为不知道) ，请使用以下单词：“未知”表示不知道设备是否支持压缩功能：“压缩”表示设备支持压缩功能，但其压缩方案未知或未披露;和“未压缩”表示设备不支持压缩功能。

此属性继承自 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

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

在创建实例时使用的继承链中显示的第一个具体类的名称。与类的其他键属性一起使用时，属性允许唯一标识此类及其子类的所有实例。

此属性继承自 CIM_LogicalDevice。

DefaultBlockSize

数据类型： uint64
访问类型：只读
限定符：单位 (“bytes”)

此设备的默认块大小（以字节为单位）。

此属性继承自 CIM_MediaAccessDevice。

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

描述

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

对象的说明。

此属性继承自 CIM_ManagedSystemElement。

DeviceID

数据类型： string
访问类型：只读
限定符： Key、 Override (“DeviceId”) 、 MappingStrings (“Win32API|文件函数 |GetLogicalDriveStrings“)

CD-ROM 驱动器的唯一标识符。

此属性继承自 CIM_LogicalDevice。

驱动

数据类型： string
访问类型：只读
限定符： MappingStrings (“Win32API|文件函数 |GetDriveType“)

CD-ROM 驱动器的驱动器号。

示例：“d：\”

DriveIntegrity

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“WMI”)

如果 为 True，则可以从 CD 设备准确读取文件。这是通过读取数据块两次并将数据与自身进行比较来实现的。

ErrorCleared

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

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

此属性继承自 CIM_LogicalDevice。

ErrorDescription

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

有关 LastErrorCode 中记录的错误的详细信息，以及有关可以采取的纠正措施的信息。

此属性继承自 CIM_LogicalDevice。

ErrorMethodology

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

此设备支持的错误检测和更正的类型。

此属性继承自 CIM_MediaAccessDevice。

FileSystemFlags

数据类型： uint16
访问类型：只读
限定符： 已弃用， MappingStrings (“Win32API|文件系统函数 |GetVolumeInformation“)

此属性已过时。使用 FileSystemFlagsEx 代替此属性。

FileSystemFlagsEx

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“Win32API|文件系统函数 |GetVolumeInformation“)

与 Windows CD-ROM 驱动器关联的文件系统标志。此参数可以是标志的任意组合，但 FS_FILE_COMPRESSION 和 FS_VOL_IS_COMPRESSED 是互斥的。

区分大小写的搜索 (1)

文件系统支持区分大小写的文件名。

保留大小写的名称 (2)

文件系统在磁盘上放置名称时保留文件名大小写。

磁盘上的 Unicode (4)

文件系统支持在磁盘上显示的文件名中的 Unicode。

持久性 ACL (8)

文件系统保留并强制实施访问控制列表 (ACL) 。例如，NTFS 文件系统保留并强制实施 ACL，而 FAT 文件系统则不这样做。

文件压缩 (16)

文件系统支持基于文件的压缩。

卷配额 (32)

文件系统支持磁盘配额。

支持稀疏文件 (64)

文件系统支持备用文件。

支持重新分析点 (128)

文件系统支持重新分析点。

支持远程存储 (256)

文件系统支持文件的远程存储。

支持长名称 (16384)

文件系统支持长度超过 8 个字符的文件名。

卷已压缩 (32768)

指定的磁盘卷是压缩卷，例如 DoubleSpace 卷。

只读卷 (524289)

指定的卷是只读的。

支持对象 IDS (65536)

文件系统支持对象标识符。

支持加密 (131072)

文件系统支持 EFS) 加密文件系统 (。

支持命名流 (262144)

文件系统支持命名流。

示例：0

数据类型： string
访问类型：只读
限定符： MappingStrings (“Win32API|文件函数 |GetDriveType“)

唯一标识此 CD-ROM 驱动器的驱动器号。

示例：“d：\”

InstallDate

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

对象的安装日期和时间。此属性不需要值来指示已安装对象。

此属性继承自 CIM_ManagedSystemElement。

LastErrorCode

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

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

此属性继承自 CIM_LogicalDevice。

Manufacturer

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

Windows CD-ROM 驱动器的制造商。

示例：“PLEXTOR”

MaxBlockSize

数据类型： uint64
访问类型：只读
限定符：单位 (“字节”)

此设备访问的媒体的最大块大小（以字节为单位）。

此属性继承自 CIM_MediaAccessDevice。

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

MaximumComponentLength

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“Win32API|文件系统函数 |GetVolumeInformation“)

Windows CD-ROM 驱动器支持的文件名组件的最大长度。文件名组件在反斜杠之间的文件名部分。值可用于指示指定的文件系统支持长名称。例如，对于支持长名称的 FAT 文件系统，函数存储值 255，而不是以前的 8.3 指示器。使用 NTFS 文件系统的系统上也支持长名称。

示例：255

MaxMediaSize

数据类型： uint64
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |顺序访问设备|001.2“) ，单位 (”千字节“)

此设备支持的媒体的最大大小（以 KB 为单位）。

此属性继承自 CIM_MediaAccessDevice。

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

MediaLoaded

数据类型： 布尔值
访问类型：只读
限定符： MappingStrings (“Win32API|文件系统函数 |GetVolumeInformation“)

如果 为 True，则驱动器中有 CD-ROM。

MediaType

数据类型： string
访问类型：只读
限定符： MappingStrings (“Win32API|GetDriveType“)

此设备可以使用或访问的媒体类型。可能的值为：

随机访问 (“随机访问”)

支持写入 (“支持写入”)

可移动媒体 (“可移动媒体”)

CD-ROM (“CD-ROM”)

MfrAssignedRevisionLevel

数据类型： string
访问类型：只读
限定符： MappingStrings (“Win2000DDK|KernelModeDrivers |STORAGE_DEVICE_DESCRIPTOR |ProductRevisionOffset“)

制造商分配的固件修订级别。

MinBlockSize

数据类型： uint64
访问类型：只读
限定符：单位 (“字节”)

此设备访问的媒体的最小块大小（以字节为单位）。

此属性继承自 CIM_MediaAccessDevice。

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

名称

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

对象的标签。子类化后，属性可以重写为键属性。

此属性继承自 CIM_ManagedSystemElement。

NeedsCleaning

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

如果 为 True，则媒体访问设备需要清洁。 Capabilities 属性中指明了是否可以进行手动或自动清理。

此属性继承自 CIM_MediaAccessDevice。

NumberOfMediaSupported

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

当媒体访问设备支持多个单独的媒体时，可以支持或插入的最大媒体数。

此属性继承自 CIM_MediaAccessDevice。

PNPDeviceID

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

Windows 即插即用逻辑设备的设备标识符。

此属性继承自 CIM_LogicalDevice。

示例：“*PNP030b”

PowerManagementCapabilities

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

逻辑设备与电源相关的特定功能的数组。

此属性继承自 CIM_LogicalDevice。

未知 (0)

不支持 (1)

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

已禁用 (2)

已启用 (3)

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

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

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

电源状态可设置 (5)

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

支持的电源循环 (6)

可以在 PowerState 参数设置为 5 的情况下调用 SetPowerState 方法， (Power Cycle) 。

支持定时开机 (7)

支持计时Power-On

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

PowerManagementSupported

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

如果 为 True，则可以对设备进行电源管理，这意味着可以将其置于挂起模式，依此推。属性不指示当前已启用电源管理功能，仅指示逻辑设备能够进行电源管理。

此属性继承自 CIM_LogicalDevice。

RevisionLevel

数据类型： string
访问类型：只读
限定符： MappingStrings (“Win32Registry|RevisionLevel“)

Windows CD-ROM 驱动器的固件修订级别。

SCSIBus

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“Win32API|SCSI 结构 |SCSI_REQUEST_BLOCK |PathId“)

磁盘驱动器的 SCSI 总线编号。

示例：0

SCSILogicalUnit

数据类型： uint16
访问类型：只读
限定符： MappingStrings (“Win32API|SCSI 结构 |SCSI_REQUEST_BLOCK |Lun“)

磁盘驱动器的 LUN) (SCSI 逻辑单元号。 LUN 用于指定在使用多个控制器的系统中要访问的 SCSI 控制器。 SCSI 设备标识符类似，但它是一个控制器上多个设备的指定。

示例：0

SCSIPort

数据类型： uint16
访问类型：只读
限定符： MappingStrings (“Win32API|SCSI 结构 |SCSI_REQUEST_BLOCK |ScsiStatus“)

磁盘驱动器的 SCSI 端口号。

示例：1

SCSITargetId

数据类型： uint16
访问类型：只读
限定符： MappingStrings (“Win32API|DeviceIoControl |IOCTL_SCSI_GET_ADDRESS“)

Windows CD-ROM 驱动器的 SCSI 标识符号。

示例：0

SerialNumber

数据类型： string
访问类型：只读
限定符： MappingStrings (“Win32API|设备输入和输出结构 |STORAGE_DEVICE_DESCRIPTOR |SerialNumberOffset“)

标识物理介质的制造商提供的编号。示例：WD-WM3493798728。

大小

数据类型： uint64
访问类型：只读
限定符： MappingStrings (“Win32API|文件函数 |GetDiskFreeSpace“) ，单位 (”bytes“)

磁盘驱动器的大小。

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

Status

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

对象的当前状态。可以定义各种操作状态和非操作状态。操作状态包括：“正常”、“已降级”和“预失败”， (启用 SMART 的硬盘驱动器等元素可能正常运行，但预测近期) 故障。非操作状态包括：“错误”、“正在启动”、“正在停止”和“服务”。后者（“服务”）可以在镜像磁盘重新同步、重新加载用户权限列表或其他管理工作期间应用。并非所有此类工作都处于联机状态，但托管元素既不是“正常”，也不是处于其他状态之一。

此属性继承自 CIM_ManagedSystemElement。

包括以下值：

OK (“OK”)

错误 (“错误”)

已降级 (“已降级”)

未知 (“未知”)

Pred Fail (“Pred Fail”)

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

正在停止 (“停止”)

服务 (“Service”)

压力 (“有压力”)

NonRecover (“NonRecover”)

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

Lost Comm (“Lost Comm”)

StatusInfo

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

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

此属性继承自 CIM_LogicalDevice。

其他 (1)

未知 (2)

已启用 (3)

已禁用 (4)

不适用 (5)

SystemCreationClassName

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

范围计算机的 CreationClassName 属性的值。

此属性继承自 CIM_LogicalDevice。

SystemName

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

范围系统的名称。

此属性继承自 CIM_LogicalDevice。

TransferRate

数据类型： real64
访问类型：只读
限定符： MappingStrings (“Win32API|文件引用和时间引用“) ，单位 (”kb/秒“)

CD-ROM 驱动器的传输速率。值为 -1 表示无法确定速率。发生这种情况时，CD 不在驱动器中。

VolumeName

数据类型： string
访问类型：只读
限定符： MappingStrings (“Win32API|文件系统函数 |GetVolumeInformation“)

Windows CD-ROM 驱动器的卷名。

VolumeSerialNumber

数据类型： string
访问类型：只读
限定符： MappingStrings (“Win32API|文件系统函数 |GetVolumeInformation“)

CD-ROM 驱动器中介质的卷序列号。

示例：A8C3-D032

备注

Win32_CDROMDrive 类派生自派生自 CIM_MediaAccessDevice 的 CIM_CDROMDrive。 CIM_MediaAccessDevice 类派生自 CIM_LogicalDevice。

示例

以下 VBScript 示例确定 CD 是否位于 CDROM 驱动器中。

strComputer = "."
Set objWMIService = GetObject(_
    "winmgmts:\\" & strComputer & "\root\cimv2")
Set colItems = objWMIService.ExecQuery( _
    "Select * from Win32_CDROMDrive")
For Each objItem in colItems
    Wscript.Echo "Device ID: " _
        & objItem.DeviceID
    Wscript.Echo "Media Loaded: " _
        & objItem.MediaLoaded
Next

要求

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

另请参阅

CIM_CDROMDrive
计算机系统硬件类
WMI 任务：计算机硬件
WMI 任务：磁盘和文件系统

通过

Win32_CDROMDrive 类

语法

成员

方法

属性

备注

示例

要求

另请参阅

反馈

其他资源