IVdsAdvancedDisk::FormatPartition メソッド (vds.h)
[Windows 8とWindows Server 2012以降、Virtual Disk Service COM インターフェイスは Windows Storage Management API に置き換えられます。
既存の OEM、ESP、または不明なパーティションを書式設定します。
構文
HRESULT FormatPartition(
[in] ULONGLONG ullOffset,
[in] VDS_FILE_SYSTEM_TYPE type,
[in] LPWSTR pwszLabel,
[in] DWORD dwUnitAllocationSize,
[in] BOOL bForce,
[in] BOOL bQuickFormat,
[in] BOOL bEnableCompression,
[out] IVdsAsync **ppAsync
);
パラメーター
[in] ullOffset
パーティション オフセット。
[in] type
使用するファイル システムを指定する VDS_FILE_SYSTEM_TYPE 列挙値。 VDS_FST_NTFS、VDS_FST_FAT、VDS_FST_FAT32、またはVDS_FST_UDFのいずれかである必要があります。
[in] pwszLabel
ボリューム ラベルを表す文字列。
[in] dwUnitAllocationSize
ファイル システムの割り当て単位のサイズ (通常は 512 ~ 65536)。
[in] bForce
TRUE の場合、使用中でもパーティションは書式設定されます。それ以外の場合、操作は失敗します。
[in] bQuickFormat
TRUE の場合、VDS はクイック形式を実行します。 クイック形式では、ボリューム上の各セクターは検証されません。
[in] bEnableCompression
TRUE の場合、新しく書式設定されたファイル システムで圧縮が有効になります。 圧縮は NTFS の機能であり、FAT および FAT32 ファイル システムでは設定できません。
[out] ppAsync
VDS が戻り時に初期化する IVdsAsync インターフェイス ポインターのアドレス。 呼び出し元はインターフェイスを解放する必要があります。 操作の状態を取り消す、待機する、またはクエリを実行するには、このポインターを使用します。
戻り値
このメソッドは、E_INVALIDARGやE_OUTOFMEMORYなどの標準の HRESULT 値と、VDS 固有の戻り値を返すことができます。 また、HRESULT_FROM_WIN32 マクロを使用して、変換されたシステム エラー コードを返すこともできます。 エラーは、VDS 自体または使用されている基になる VDS プロバイダー から発生する可能性があります。 可能な戻り値は次のとおりです。
| リターン コード/値 | 説明 |
|---|---|
|
パーティションが正常に書式設定されました。 |
|
ディスクがリムーバブルであるか、パーティションの種類が OEM、ESP、または不明ではありません。 |
|
パーティションが存在しません。 |
注釈
VDS は、このメソッドを実装します。
このメソッドは、OEM、ESP、不明なパーティションのみを書式設定します。 他のパーティションの場合は、代わりに IVdsVolumeMF::Format メソッドまたは IVdsVolumeMF2:: FormatEx メソッドを使用して、対応するボリュームの 書式を設定 する必要があります。 OEM、ESP、および不明なパーティションはボリュームとして公開されないため、 Format または FormatEx で書式設定できないことに注意してください。
このメソッドは、リムーバブル メディアの書式設定には使用できません。
最小および最大の割り当て単位サイズ (クラスター サイズとも呼ばれます) などのファイル システムの制限については、「 NTFS テクニカル リファレンス 」と「 FAT テクニカル リファレンス」を参照してください。
OEM パーティションが FAT または FAT32 として書式設定されている場合、パーティションの種類は変更されません。 NTFS でフォーマットされている場合、パーティションの種類は PARTITION_IFS (0x07) に変わります。 パーティションの種類の詳細については、「 CREATE_PARTITION_PARAMETERS」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | vds.h |
| Library | Uuid.lib |