MSFT_Volume 類別的格式方法
格式化磁碟區。
語法
UInt32 Format(
[in] String FileSystem,
[in] String FileSystemLabel,
[in] UInt32 AllocationUnitSize,
[in] Boolean Full,
[in] Boolean Force,
[in] Boolean Compress,
[in] Boolean ShortFileNameSupport,
[in] Boolean SetIntegrityStreams,
[in] Boolean UseLargeFRS,
[in] Boolean DisableHeatGathering,
[out] String FormattedVolume,
[out] String ExtendedStatus
);
參數
FileSystem [in]
要套用至磁碟區的文件系統。 下列其中一項：
- “ExFAT”
- “FAT”
- “FAT32”
- “NTFS”
- “ReFS”
FileSystemLabel [in]
磁碟區的文件系統標籤。
AllocationUnitSize [in]
配置單位大小，以位元組為單位。
完整 [in]
若為完整格式，則為TRUE ，或 為 FALSE 表示快速格式。
強制 [in]
TRUE 表示強制格式作業，否則為 FALSE。
壓縮 [in]
TRUE 表示壓縮磁碟區，否則為 FALSE。 如果 FileSystem 設定為 ReFS ，則保持未定義。
ShortFileNameSupport [in]
如果磁碟區應該支援簡短名稱，則為TRUE ，否則為 FALSE。 如果 FileSystem 設定為 ReFS ，則保持未定義。
SetIntegrityStreams [in]
TRUE 可設定完整性數據流。 除非 FileSystem 設定為 ReFS ，否則保持未定義。
UseLargeFRS [in]
TRUE 表示使用大型 FRS，否則為 FALSE。 如果 FileSystem 設定為 ReFS ，則保持未定義。
DisableHeatGathering [in]
TRUE 表示停用收集熱，否則為 FALSE。
FormattedVolume [out]
接收代表 格式化磁碟區的 MSFT_Volume 物件。
ExtendedStatus [out]
包含內嵌MSFT_儲存體 ExtendedStatus 物件。
此參數可讓記憶體提供者傳回擴充的（實作特定）錯誤資訊。
傳回值
成功 （0）
不支援 （1）
未指定的錯誤 （2）
逾時 （3）
失敗 （4）
不合法的參數 （5）
在 x64 環境中執行的 x86 不支援此命令。 (7)
拒絕 存取 （40001）
發生 非預期的 I/O 錯誤 （40004）
指定的物件是由 Microsoft 故障轉移叢集元件所管理。 磁碟必須處於叢集維護模式，且叢集資源狀態必須為在線，才能執行這項作業。 (40018)
系統或重要分割區上不允許此作業。 (42010)
指定的叢集大小無效 （43000）
不支援 指定的檔案系統 （43001）
磁碟區 無法快速格式化 （43002）
叢集數目超過 32 位 （43003）
不支援 指定的 UDF 版本 （43004）
叢集大小必須是磁碟實體扇區大小的 倍數（43005）
當磁碟驅動器為唯讀 時，無法執行要求的作業 （43006）
需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
| Namespace | Root\Microsoft\Windows\儲存體 |
| MOF | 儲存體 wmi.mof |