ホーム › Storage.VirtualDiskService › IVdsDiskPartitionMF2

IVdsDiskPartitionMF2

COM

IID9cbe50ca-f2d2-4bf4-ace1-96896b729625継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

追加のフォーマットオプションを指定してパーティションをフォーマットするメソッドを提供します。

メソッド 1

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT FormatPartitionEx2(ULONGLONG ullOffset, LPWSTR pwszFileSystemTypeName, WORD usFileSystemRevision, DWORD ulDesiredUnitAllocationSize, LPWSTR pwszLabel, DWORD Options, IVdsAsync** ppAsync)

既存の OEM、ESP、または不明なパーティションをフォーマットします。このメソッドは IVdsDiskPartitionMF::FormatPartition メソッドと同一ですが、フォーマットオプションを Options パラメーターで指定する点が異なります。

ullOffset	ULONGLONG	in	ディスクの先頭からのパーティションのバイトオフセット。このオフセットはパーティションの開始位置のオフセットである必要があります。
pwszFileSystemTypeName	LPWSTR	in	パーティションのフォーマットに使用するファイルシステムの名前を含む NULL で終端された Unicode 文字列。NULL、または次のいずれかである必要があります: "NTFS"、"FAT"、"FAT32"、"UDF"、"EXFAT"。このパラメーターが NULL の場合は既定値が使用されます。詳細については VDS_FILE_SYSTEM_FORMAT_SUPPORT_FLAG を参照してください。
usFileSystemRevision	WORD	in	ファイルシステムのリビジョン(存在する場合)。このメンバーは 16 ビットの二進化十進数として表され、2 桁目と 3 桁目の間に小数点があると見なされます。たとえば値 0x0250 はリビジョン 2.50 を示します。
ulDesiredUnitAllocationSize	DWORD	in	ファイルシステムのアロケーションユニットのサイズ(バイト単位)。値は 2 のべき乗である必要があります。値が 0 の場合は、ファイルシステムの種類によって決定される既定のアロケーションユニットが使用されます。アロケーションユニットの範囲はファイルシステムに依存します。
pwszLabel	LPWSTR	in	パーティションの新しいファイルシステムに割り当てるラベルを含む NULL で終端された Unicode 文字列。ラベルの最大サイズはファイルシステムに依存します。
Options	DWORD	in	フォーマットオプションを指定する VDS_FORMAT_OPTION_FLAGS 列挙値のビットマスク。
ppAsync	IVdsAsync**	out	正常に完了すると、この操作を監視および制御するための IVdsAsync インターフェイスを受け取る IVdsAsync インターフェイスへのポインター。呼び出し側は、受け取ったインターフェイスの使用が完了したら解放する必要があります。

戻り値

このメソッドは、E_INVALIDARG や E_OUTOFMEMORY などの標準的な HRESULT 値、および VDS 固有の戻り値を返すことができます。また、HRESULT_FROM_WIN32 マクロを使用して変換されたシステムエラーコードを返すこともあります。エラーは VDS 自体、または使用されている基盤の VDS プロバイダーから発生する可能性があります。返される可能性のある値には次のものがあります。

戻り値コード/値	説明
S_OK	ボリュームは正常にパーティション分割されました。
VDS_E_BAD_PROVIDER_DATA 0x80042441L	プロバイダーが不正なデータを返しました。
VDS_E_DISK_REMOVEABLE 0x8004255AL	この操作はリムーバブルメディアではサポートされていません。
VDS_E_FS_NOT_DETERMINED 0x80042593L	既定のファイルシステムを判別できませんでした。
VDS_E_MISSING_DISK 0x80042454L	ディスクが見つかりません。
VDS_E_OBJECT_NOT_FOUND 0x80042405L	パーティションが存在しません。
VDS_E_PARTITION_NOT_OEM 0x8004256FL	この操作は OEM 以外のパーティションではサポートされていません。

さらに、IVdsAsync インターフェイスは、次の関連する警告およびエラーコードを返す場合があります。

戻り値コード/値	説明
VDS_S_VOLUME_COMPRESS_FAILED 0x00042443L	ファイルシステムはフォーマットされましたが、圧縮されていません。
VDS_E_ACCESS_DENIED 0x80042427L	アクセスが拒否されました。
VDS_E_BAD_LABEL 0x80042429L	ラベルが無効です。
VDS_E_CANT_QUICK_FORMAT 0x8004242AL	ボリュームをクイックフォーマットできません。
VDS_E_CLUSTER_COUNT_BEYOND_32BITS 0x80042430L	クラスター数が大きすぎて 32 ビット整数として表現できません。
VDS_E_CLUSTER_SIZE_TOO_BIG 0x8004242FL	クラスターサイズが大きすぎてフォーマットできません。
VDS_E_CLUSTER_SIZE_TOO_SMALL 0x8004242EL	クラスターサイズが小さすぎてフォーマットできません。
VDS_E_INCOMPATIBLE_FILE_SYSTEM 0x80042425L	ファイルシステムに互換性がありません。
VDS_E_INCOMPATIBLE_MEDIA 0x80042426L	メディアに互換性がありません。
VDS_E_IO_ERROR 0x8004242BL	フォーマット中に I/O エラーが発生しました。
VDS_E_MEDIA_WRITE_PROTECTED 0x80042428L	メディアは書き込み保護されています。
VDS_E_VOLUME_TOO_BIG 0x8004242DL	ボリュームサイズが大きすぎてフォーマットできません。
VDS_E_VOLUME_TOO_SMALL 0x8004242CL	ボリュームサイズが小さすぎてフォーマットできません。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

#define global IID_IVdsDiskPartitionMF2 "{9CBE50CA-F2D2-4BF4-ACE1-96896B729625}"
#usecom global IVdsDiskPartitionMF2 IID_IVdsDiskPartitionMF2 "{}"
#comfunc global IVdsDiskPartitionMF2_FormatPartitionEx2  3 int64,wstr,int,int,wstr,int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。