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 プロバイダー から発生する可能性があります。 可能な戻り値は次のとおりです。

注釈

VDS は、このメソッドを実装します。

このメソッドは、OEM、ESP、不明なパーティションのみを書式設定します。 他のパーティションの場合は、代わりに IVdsVolumeMF::Format メソッドまたは IVdsVolumeMF2:: FormatEx メソッドを使用して、対応するボリュームの 書式を設定 する必要があります。 OEM、ESP、および不明なパーティションはボリュームとして公開されないため、 Format または FormatEx で書式設定できないことに注意してください。

このメソッドは、リムーバブル メディアの書式設定には使用できません。

最小および最大の割り当て単位サイズ (クラスター サイズとも呼ばれます) などのファイル システムの制限については、「 NTFS テクニカル リファレンス 」と「 FAT テクニカル リファレンス」を参照してください。

OEM パーティションが FAT または FAT32 として書式設定されている場合、パーティションの種類は変更されません。 NTFS でフォーマットされている場合、パーティションの種類は PARTITION_IFS (0x07) に変わります。 パーティションの種類の詳細については、「 CREATE_PARTITION_PARAMETERS」を参照してください。

要件

こちらもご覧ください

Disk オブジェクト

IVdsAdvancedDisk

IVdsAsync

IVdsDiskPartitionMF::FormatPartitionEx

VDS_FILE_SYSTEM_TYPE