Win32 _ CDROMDrive 类

Win32 _ CDROMDrive WMI 类表示运行 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 for 文档中的 Reset方法。
SetPowerState 未实现。 若要实现此方法,请参阅 CIM _ CDROMDrive for 文档中的 SetPowerState方法。

属性

Win32 _ CDROMDrive 类具有以下属性。

可用性

数据类型: uint16

访问类型:只读

限定符: MappingStrings ( "MIF。DMTF | 操作状态 | 003.5 "," MIB。IETF | 主机资源-hrDeviceStatus ")

设备的可用性和状态。

此属性是从 CIM _ LogicalDevice继承而来的。

其他 (1)

未知 (2)

运行/完整 Power (3)

运行或全速

警告 (4)

在测试 (5)

不适用 (6)

断电 (7)

空行 (8)

关闭关税 (9)

(10) 降级

未安装 (11)

安装错误 (12)

节能-未知 (13)

已知设备处于省电模式,但其确切状态为未知。

电-低功耗模式 (14)

设备处于省电状态,但仍处于正常工作状态,并且可能会导致性能下降。

节能-备用 (15)

设备无法正常工作,但可能会迅速进入全部电量。

电源周期 (16)

节能-警告 (17)

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

暂停 (18)

设备已暂停。

未准备好 (19)

设备未准备就绪。

未配置 (20)

设备未配置。

静止 (21)

设备为静默设备。

功能

数据类型: uint16 数组

访问类型:只读

限定符: ArrayType ( "Indexed" ) , MAPPINGSTRINGS ( "MIF。DMTF | 存储设备 | 001.9 "," MIF。DMTF | 存储设备 | 001.11 "," MIF。DMTF | 存储设备 | 001.12 "," MIF。DMTF | 磁盘 | 003.7 ") , ModelCorrespondence ("CIM _ MediaAccessDeviceCapabilityDescriptions")

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

此属性是从 CIM _ MediaAccessDevice继承而来的。

未知 (0)

其他 (1)

顺序访问 (2)

随机访问 (3)

支持写入 (4)

加密 (5)

压缩 (6)

支持可移动媒体 (7)

支持可移动介质

手动清洗 (8)

自动清洗 (9)

智能通知 (10)

支持双面媒体 (11)

支持 Dual-Sided 媒体

不需要 Predismount 弹出 (12)

CapabilityDescriptions

数据类型: 字符串 数组

访问类型:只读

限定符: ArrayType ( "Indexed" ) , ModelCorrespondence ( "CIM _ MediaAccessDevice功能")

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

此属性是从 CIM _ MediaAccessDevice继承而来的。

Caption

数据类型: 字符串

访问类型:只读

限定符: MaxLen (64) , DisplayName ( "Caption" )

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

此属性是从 CIM _ ManagedSystemElement继承而来的。

CompressionMethod

数据类型: 字符串

访问类型:只读

设备用于支持压缩的算法或工具。 如果不可能或不需要描述压缩方案 (可能是因为它是未知) ,请使用以下词语: "Unknown" 表示设备是否支持压缩功能;"压缩" 表示设备支持压缩功能,但它的压缩方案未知或未泄露;和 "未压缩" 表示设备不支持压缩功能。

此属性继承自 CIM _ MediaAccessDevice

("未知")

压缩方案未知或未描述。

("Compressed")

逻辑文件已压缩,但压缩方案未知或未描述

("未压缩")

如果未压缩逻辑文件

ConfigManagerErrorCode

数据类型 :uint32

访问类型:只读

限定符 :架构 ("Win32")

Windows配置服务器错误代码。

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

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

此属性继承自 CIM _ LogicalDevice

DefaultBlockSize

数据类型 :uint64

访问类型:只读

限定符 : ( 字节")

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

此属性继承自 CIM _ MediaAccessDevice

有关在脚本中使用 uint64 值的信息,请参阅 WMI 中的脚本

说明

数据类型 :string

访问类型:只读

限定符 :DisplayName ("Description")

对象的说明。

此属性继承自 CIM _ ManagedSystemElement

DeviceID

数据类型 :string

访问类型:只读

限定符:替代 ("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")

与 CD-ROM 驱动器Windows文件系统标志。 此参数可以是标志的任意组合,但 FS _ FILE _ COMPRESSION 和 FS VOL IS _ _ _ COMPRESSED 是互斥的。

区分大小写的搜索 (1)

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

大小写保留名称 ( 2)

当文件系统将名称放在磁盘上时,它会保留文件名的大小写。

Unicode On Disk ( 4)

文件系统在文件名中支持 Unicode,因为它们出现在磁盘上。

持久性 ACL ( 8)

文件系统保留并强制实施访问控制列表 (ACL) 。 例如,NTFS 文件系统保留并强制实施 ACL,而 FAT 文件系统不会。

文件压缩 ( 16)

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

卷配额 (32)

文件系统支持磁盘配额。

支持 64 (稀疏)

文件系统支持备用文件。

支持重分析点 (128)

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

支持远程存储 ( 256)

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

支持长名称 ( 16384)

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

卷已压缩 ( 32768)

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

只读卷 (524289)

指定的卷是只读的。

支持对象 ID ( 65536)

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

支持加密 (131072)

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

支持命名流 (262144)

文件系统支持命名流。

示例:0

Id

数据类型 :string

访问类型:只读

限定符 :MappingStrings ("Win32API | 文件函数 | GetDriveType")

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

示例:"d: \ "

InstallDate

数据类型 :datetime

访问类型:只读

限定符 :MappingStrings ("MIF" 。DMTF | ComponentID | 001.5") ,DisplayName ("Install Date")

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

此属性继承自 CIM _ ManagedSystemElement

LastErrorCode

数据类型 :uint32

访问类型:只读

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

此属性继承自 CIM _ LogicalDevice

Manufacturer

数据类型 :string

访问类型:只读

限定符 :MappingStrings ("Win32Registry")

CD-ROM Windows制造商。

示例:"PLEXTOR"

MaxBlockSize

数据类型 :uint64

访问类型:只读

限定符 : ( 字节")

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

此属性继承自 CIM _ MediaAccessDevice

有关在脚本中使用 uint64 值的信息,请参阅 WMI 中的脚本

MaximumComponentLength

数据类型 :uint32

访问类型:只读

限定符 :MappingStrings ("Win32API 文件系统 | 函数 | GetVolumeInformation")

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

示例:255

MaxMediaSize

数据类型 :uint64

访问类型:只读

限定符 :MappingStrings ("MIF" 。DMTF | 顺序访问设备 | 001.2") , ("KB")

此设备支持的最大媒体大小(以 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, 则媒体访问设备需要清理。 "功能"属性中指示是否可以手动 或自动 清理。

此属性继承自 CIM _ MediaAccessDevice

NumberOfMediaSupported

数据类型 :uint32

访问类型:只读

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

此属性继承自 CIM _ MediaAccessDevice

PNPDeviceID

数据类型 :string

访问类型:只读

限定符: 架构 ("Win32")

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

此属性继承自 CIM _ LogicalDevice

示例 * :"PNP030b"

PowerManagementCapabilities

数据类型 :uint16 数组

访问类型:只读

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

此属性继承自 CIM _ LogicalDevice

未知 (0)

不支持 ( 1)

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

已禁用 (2)

已启用 (3)

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

自动输入的省电模式 ( 4)

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

Power State Settable ( 5)

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

Power 循环支持 ( 6)

可以使用 Power Cycle 参数设置为 5 的 PowerState 参数调用 SetPowerState (Power Cycle) 。

7 天 支持的时间 (电源)

支持的Power-On时间

可以在 PowerState 参数设置为 5 时调用 SetPowerState方法 (Power Cycle) 将 Time 设置为特定日期和时间(或间隔)以打开电源。

PowerManagementSupported

数据类型: 布尔值

访问类型:只读

如果 为 True, 则设备可以是电源管理的,这意味着它可以进入挂起模式,等等。 属性不指示当前已启用电源管理功能,仅表示逻辑设备能够进行电源管理。

此属性继承自 CIM _ LogicalDevice

RevisionLevel

数据类型 :string

访问类型:只读

限定符 :MappingStrings ("Win32Registry | RevisionLevel")

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

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")

CD-ROM 驱动器Windows 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

包括以下值:

确定 ("确定")

错误 ( "错误" )

降级 ( "降级" )

未知 的 ( "unknown" )

Pred 失败 ( "Pred fail" )

开始 ( "开始" )

正在停止 ( "正在停止" )

服务 ( "服务" )

压力 ( "压力" )

NonRecover ( "NonRecover" )

没有联系人 ( "无联系" )

通信丢失 ( "已丢失通信" )

StatusInfo

数据类型: uint16

访问类型:只读

限定符: MappingStrings ( "MIF。DMTF | 操作状态 | 003.3 ")

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

此属性是从 CIM _ LogicalDevice继承而来的。

其他 (1)

未知 (2)

已启用 (3)

已禁用 (4)

不适用 (5)

SystemCreationClassName

数据类型: 字符串

访问类型:只读

限定符: ( "CIM _ 系统传播CreationClassName") , CIM _ 密钥

作用域计算机的 CreationClassName 属性的值。

此属性是从 CIM _ LogicalDevice继承而来的。

SystemName

数据类型: 字符串

访问类型:只读

限定符: ( "CIM _ 系统传播名称") , CIM _ 密钥

作用域系统的名称。

此属性是从 CIM _ LogicalDevice继承而来的。

TransferRate

数据类型: real64

访问类型:只读

限定符: MappingStrings ( "Win32API | 文件引用和时间引用" ) , 单位 ( "千字节/秒" )

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

VolumeName

数据类型: 字符串

访问类型:只读

限定符: MappingStrings ( "Win32API | 文件系统函数 | GetVolumeInformation" )

Windows cd-rom 驱动器的卷名。

VolumeSerialNumber

数据类型: 字符串

访问类型:只读

限定符: MappingStrings ( "Win32API | 文件系统函数 | GetVolumeInformation" )

Cd-rom 驱动器中媒体的卷序列号。

示例: A8C3-D032

备注

Win32 _ CDROMDrive 类派生自 cim _ MediaAccessDevice派生的 cim _ CDROMDriveCim _ MediaAccessDevice 类派生自 cim _ LogicalDevice

示例

以下 VBScript 示例确定光盘是否在 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
命名空间
根 \ CIMV2
MOF
CIMWin32
DLL
CIMWin32.dll

另请参阅

CIM _ CDROMDrive

计算机系统硬件类

WMI 任务:计算机硬件

WMI 任务:磁盘和文件系统