Win32_TapeDrive 类

项目
06/12/2023

Win32_TapeDriveWMI 类表示运行 Windows 的计算机系统上的磁带驱动器。磁带驱动器的区别主要在于它们只能按顺序访问。

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

语法

[Dynamic, Provider("CIMWin32"), UUID("{8502C4B1-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_TapeDrive : CIM_TapeDrive
{
  uint16   Availability;
  uint16   Capabilities[];
  string   CapabilityDescriptions[];
  string   Caption;
  uint32   Compression;
  string   CompressionMethod;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  uint64   DefaultBlockSize;
  string   Description;
  string   DeviceID;
  uint32   ECC;
  uint32   EOTWarningZoneSize;
  boolean  ErrorCleared;
  string   ErrorDescription;
  string   ErrorMethodology;
  uint32   FeaturesHigh;
  uint32   FeaturesLow;
  string   Id;
  datetime InstallDate;
  uint32   LastErrorCode;
  string   Manufacturer;
  uint64   MaxBlockSize;
  uint64   MaxMediaSize;
  uint32   MaxPartitionCount;
  string   MediaType;
  uint64   MinBlockSize;
  string   Name;
  boolean  NeedsCleaning;
  uint32   NumberOfMediaSupported;
  uint32   Padding;
  string   PNPDeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  uint32   ReportSetMarks;
  string   Status;
  uint16   StatusInfo;
  string   SystemCreationClassName;
  string   SystemName;
};

成员

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

方法
属性

方法

Win32_TapeDrive 类具有这些方法。

方法	说明
重置	未实现。若要实现此方法，请参阅 CIM_TapeDrive 中的 Reset 方法。
SetPowerState	未实现。若要实现此方法，请参阅 CIM_TapeDrive 中的 SetPowerState 方法。

属性

Win32_TapeDrive 类具有这些属性。

可用性

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

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

电源周期 (16)

节电 - 警告 (17)

设备处于警告状态，不过也处于节电模式。

暂停 (18)

设备已暂停。

未就绪 (19)

设备未准备就绪。

未配置 (20)

设备未配置。

静止 (21)

设备安静。

功能

数据类型： uint16 数组
访问类型：只读
限定符： ArrayType (“Indexed”) ， MappingStrings (“MIF。DMTF |存储设备|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

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

对象的简短说明。

此属性继承自 CIM_ManagedSystemElement。

压缩

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“Win32API|磁带备份结构 |TAPE_GET_DRIVE_PARAMETERS|Compression“)

如果 为 TRUE，则启用硬件数据压缩。

FALSE

TRUE

CompressionMethod

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

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

此属性继承自 CIM_MediaAccessDevice。

(“未知”)

压缩方案未知或未描述。

(“Compressed”)

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

(“未压缩”)

如果逻辑文件未压缩

ConfigManagerErrorCode

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

Win32 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 中编写脚本。

描述

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

对象的说明。

此属性继承自 CIM_ManagedSystemElement。

DeviceID

数据类型： 字符串
访问类型：只读
限定符：键、重写 (“DeviceId”) 、 MappingStrings (“Win32API|文件函数 |CreateFile“)

带系统上其他设备的磁带驱动器的唯一标识符。

此属性继承自 CIM_LogicalDevice。

ECC

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“Win32API|磁带备份结构 |TAPE_GET_DRIVE_PARAMETERS|ECC“)

如果 为 TRUE，则设备支持硬件纠错。

false (0)

true (1)

EOTWarningZoneSize

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

磁带末尾的区域大小 (EOT) 警告。

此属性继承自 CIM_TapeDrive。

ErrorCleared

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

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

此属性继承自 CIM_LogicalDevice。

ErrorDescription

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

自由格式字符串，提供有关 LastErrorCode 中记录的错误的详细信息，以及有关可能采取的任何纠正措施的信息。

此属性继承自 CIM_LogicalDevice。

ErrorMethodology

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

描述此设备支持的错误检测和更正类型的自由格式字符串。

此属性继承自 CIM_MediaAccessDevice。

FeaturesHigh

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“Win32API|磁带备份结构 |TAPE_GET_DRIVE_PARAMETERS|FeaturesHigh“)

设备功能标志的高阶 32 位。

FeaturesLow

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“Win32API|磁带备份结构 |TAPE_GET_DRIVE_PARAMETERS|FeaturesLow“)

低序 32 位的设备功能标志。

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

Windows CD ROM 驱动器的制造商标识名称。

示例：“PLEXTOR CD-ROM PX-12CS 1.01”

InstallDate

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

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

此属性继承自 CIM_ManagedSystemElement。

LastErrorCode

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

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

此属性继承自 CIM_LogicalDevice。

Manufacturer

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

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

示例：“PLEXTOR”

MaxBlockSize

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

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

此属性继承自 CIM_MediaAccessDevice。

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

MaxMediaSize

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

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

此属性继承自 CIM_MediaAccessDevice。

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

MaxPartitionCount

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

磁带驱动器的最大分区计数。

此属性继承自 CIM_TapeDrive。

MediaType

数据类型： 字符串
访问类型：只读
限定符： MappingStrings (“Win32_TapeDrive|MediaType |磁带驱动器“)

(使用的媒体类型或) 此设备访问的媒体类型。在本例中，它设置为“磁带驱动器”。

MinBlockSize

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

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

此属性继承自 CIM_MediaAccessDevice。

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

名称

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

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

此属性继承自 CIM_ManagedSystemElement。

NeedsCleaning

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

如果 为 TRUE，则媒体访问设备需要清理。 “功能”属性中指明了可以手动清理还是自动清理。

此属性继承自 CIM_MediaAccessDevice。

NumberOfMediaSupported

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

支持) 时，可在媒体访问设备 (中支持或插入的单个媒体的最大数量。

此属性继承自 CIM_MediaAccessDevice。

填充

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

在磁带介质上的块之间插入的字节数。

此属性继承自 CIM_TapeDrive。

PNPDeviceID

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

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

此属性继承自 CIM_LogicalDevice。

示例：“*PNP030b”

PowerManagementCapabilities

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

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

此属性继承自 CIM_LogicalDevice。

未知 (0)

不支持 (1)

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

禁用 (2)

已启用 (3)

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

自动进入节能模式 (4)

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

Power State Settable (5)

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

支持电源循环 (6)

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

支持计时开机 (7)

支持计时Power-On

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

PowerManagementSupported

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

如果 为 TRUE，则设备可以进行电源管理 (可以置于挂起模式，依此) 。属性并不指示当前已启用电源管理功能，仅指示逻辑设备能够进行电源管理。

此属性继承自 CIM_LogicalDevice。

ReportSetMarks

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“Win32API|磁带备份结构 |TAPE_GET_DRIVE_PARAMETERS|ReportSetmarks“)

如果 为 TRUE，则启用 setmark 报告。 Setmark 报告使用不包含用户数据的专用记录元素。此记录的元素用于提供分层优于文件标记的分段方案。 Setmark 在高容量磁带上提供更快的定位。

FALSE

TRUE

Status

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

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

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

范围系统的名称。

此属性继承自 CIM_LogicalDevice。

备注

Win32_TapeDrive 类派生自 CIM_TapeDrive。

要求

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

另请参阅

CIM_TapeDrive
计算机系统硬件类

通过

Win32_TapeDrive 类

语法

成员

方法

属性

备注

要求

另请参阅

反馈

其他资源