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類別具有這些方法。

方法	Description
重設	未實作。若要實作此方法，請參閱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)

裝置無法運作，但可能會快速進入完整電源。

Power Cycle (16)

電源儲存 - 警告 (17)

裝置處於警告狀態，但也會處於省電模式。

暫停 (18)

裝置已暫停。

未就緒 (19)

裝置未就緒。

未設定 (20)

裝置未設定。

停止 (21)

裝置很無訊息。

Capabilities

資料類型： 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。

標題

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

物件的簡短描述。

此屬性繼承自 CIM_ManagedSystemElement。

壓縮

資料類型： uint32
存取類型：唯讀
限定詞： MappingStrings (「Win32API|磁帶備份結構 |TAPE_GET_DRIVE_PARAMETERS|壓縮「)

如果 為 TRUE，則會啟用硬體資料壓縮。

false

true

CompressionMethod

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

自由格式字串，指出裝置用來支援壓縮的演算法或工具。如果無法或不想描述壓縮配置 (可能是因為不知道) ，請使用下列文字：「未知」來表示裝置是否支援壓縮功能;「壓縮」表示裝置支援壓縮功能，但其壓縮配置未知或未揭露;和「未壓縮」表示裝置不支援壓縮功能。

此屬性繼承自 CIM_MediaAccessDevice。

(「Unknown」)

壓縮配置未知或未描述。

(「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 (」Install Date「)

安裝物件的日期和時間。這個屬性不需要值來指出已安裝物件。

此屬性繼承自 CIM_ManagedSystemElement。

LastErrorCode

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

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

此屬性繼承自 CIM_LogicalDevice。

製造商

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

Windows CD-ROM 磁片磁碟機的製造商。

範例：「PLEXTOR」

MaxBlockSize

資料類型： uint64
存取類型：唯讀
限定詞：單位 (「bytes」)

此裝置所存取媒體的區塊大小上限，以位元組為單位。

此屬性繼承自 CIM_MediaAccessDevice。

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

MaxMediaSize

資料類型： uint64
存取類型：唯讀
限定詞： MappingStrings (「MIF。DMTF|循序存取裝置|001.2「) ，單位 (」KB「)

此裝置支援的媒體大小上限，以 KB 為單位。

此屬性繼承自 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，媒體存取裝置需要清除。是否可以在 Capabilities 屬性中指出手動或自動清除。

此屬性繼承自 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 類別上，而且可以實作。如需詳細資訊，請參閱設計 Managed 物件格式 (MOF) 類別。

(6) 支援的電源迴圈

您可以叫用 SetPowerState 方法，並將 PowerState 參數設定為 5 (Power Cycle) 。

支援的計時電源 (7)

支援的計時Power-On

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

PowerManagementSupported

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

如果 為 TRUE，則裝置可以受電源管理， (可以進入暫停模式，依此類) 。屬性不會指出電源管理功能目前已啟用，只有邏輯裝置能夠進行電源管理。

此屬性繼承自 CIM_LogicalDevice。

ReportSetMarks

資料類型： uint32
存取類型：唯讀
限定詞： MappingStrings (「Win32API|磁帶備份結構 |TAPE_GET_DRIVE_PARAMETERS|ReportSetmarks「)

如果 為 TRUE，則會啟用 setmark 報告。 Setmark 報告會使用不包含使用者資料的特殊記錄專案。這個記錄的元素是用來提供階層式優於檔案標記的分割配置。 Setmark 可在高容量磁帶上提供更快的位置。

FALSE

true

狀態

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

物件的目前狀態。您可以定義各種作業和非操作狀態。作業狀態包括：「確定」、「已降級」和「預先失敗」 (啟用 SMART 功能的硬碟等元素可能正常運作，但預測近期) 失敗。非操作狀態包括：「Error」、「Starting」、「Stopping」和「Service」。後者「服務」可能會在磁片的鏡像重新處理期間套用、重載使用者權限清單或其他系統管理工作。並非所有這類工作都在線上，但 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

範圍電腦的 CreationClassName 屬性值。

此屬性繼承自 CIM_LogicalDevice。

SystemName

資料類型：字串
存取類型：唯讀
限定詞：傳播 (「CIM_System。名稱「) ， 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類別

語法

成員

方法

屬性

備註

規格需求

另請參閱

意見反應

其他資源