ホーム › Storage.VirtualDiskService › IVdsVolumeMF2

IVdsVolumeMF2

COM

📘 Microsoft Learn (日本語) · English

IID4dbcee9a-6343-4651-b85f-5e75d74d983c継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

ボリュームオブジェクトに対して、追加のファイルシステム管理操作を実行するメソッドを提供します。(IVdsVolumeMF2)

メソッド 3

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

vtbl 3 HRESULT GetFileSystemTypeName(LPWSTR* ppwszFileSystemTypeName)

ボリューム上のファイルシステムの名前を取得します。

ppwszFileSystemTypeName

LPWSTR*

out

正常に完了すると、ファイルシステム名を格納した null 終端の Unicode 文字列を受け取るポインター。

戻り値

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

リターンコード	説明
S_OK	メソッドは正常に完了しました。

vtbl 4 HRESULT QueryFileSystemFormatSupport(VDS_FILE_SYSTEM_FORMAT_SUPPORT_PROP** ppFileSystemSupportProps, INT* plNumberOfFileSystems)

ボリュームのフォーマットに対応しているファイルシステムのプロパティを取得します。

ppFileSystemSupportProps	VDS_FILE_SYSTEM_FORMAT_SUPPORT_PROP**	out	呼び出し元から渡される VDS_FILE_SYSTEM_FORMAT_SUPPORT_PROP 構造体の配列へのポインター。正常に完了すると、これらの構造体には対応するファイルシステムのプロパティに関する情報が格納されます。呼び出し元は、 CoTaskMemFree 関数を使用してこの配列を解放する必要があります。
plNumberOfFileSystems	INT*	out	正常に完了すると、ppFileSystemSupportProps パラメーターが指す配列内の要素の総数を受け取る変数へのポインター。

戻り値

リターンコード	説明
S_OK	メソッドは正常に完了しました。

vtbl 5 HRESULT FormatEx(LPWSTR pwszFileSystemTypeName, WORD usFileSystemRevision, DWORD ulDesiredUnitAllocationSize, LPWSTR pwszLabel, BOOL bForce, BOOL bQuickFormat, BOOL bEnableCompression, IVdsAsync** ppAsync)

パーティション上にファイルシステムボリュームをフォーマットします。

pwszFileSystemTypeName	LPWSTR	in	ボリュームのフォーマットに使用するファイルシステムの名前を格納した Null 終端の Unicode 文字列。このパラメーターには NULL、または Windows のファイルシステムの名前を指定できます。対応するファイルシステムは "NTFS"、"FAT"、"FAT32"、"UDF"、"EXFAT" です。このパラメーターが NULL の場合は、既定のファイルシステムが使用されます。詳細については、VDS_FILE_SYSTEM_FORMAT_SUPPORT_FLAG を参照してください。
usFileSystemRevision	WORD	in	ファイルシステムのリビジョン(存在する場合)。このメンバーは 16 ビットの 2 進化 10 進数として表現され、2 桁目と 3 桁目の間に小数点があるものとみなされます。たとえば、値 0x0250 はリビジョン 2.50 を示します。
ulDesiredUnitAllocationSize	DWORD	in	ファイルシステムのアロケーションユニットのサイズ(バイト単位)。値は 2 のべき乗である必要があります。値が 0 の場合は、ファイルシステムの種類によって決まる既定のアロケーションユニットが使用されます。アロケーションユニットの範囲はファイルシステムに依存します。
pwszLabel	LPWSTR	in	新しいファイルシステムに割り当てる Null 終端の Unicode 文字列。ラベルの最大サイズはファイルシステムに依存します。
bForce	BOOL	in	パーティションが使用中かどうかにかかわらず、ファイルシステムのフォーマットを強制するかどうかを決定するブール値。
bQuickFormat	BOOL	in	ファイルシステムボリュームをクイックフォーマットするかどうかを決定するブール値。クイックフォーマットでは、ボリューム上の各セクターは検証されません。
bEnableCompression	BOOL	in	圧縮を有効にしてファイルシステムボリュームを作成するかどうかを決定するブール値。注意ファイルシステムが NTFS でない場合、このパラメーターは無視されます。
ppAsync	IVdsAsync**	out	正常に完了すると、この操作を監視および制御するための IVdsAsync インターフェースを受け取る IVdsAsync インターフェースへのポインター。呼び出し元は、受け取ったインターフェースの使用が終わったら解放する必要があります。

戻り値

リターンコード/値	説明
S_OK 0x00000000L	ファイルシステムは正常にフォーマットされました。
VDS_E_OPERATION_DENIED 0x8004240AL	呼び出し元がシステム、ブート、クラッシュダンプ、ハイバネーション、またはページファイルのボリュームをフォーマットしようとした場合、操作は拒否されます。
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	ボリュームが失敗しました。
VDS_E_PACK_OFFLINE 0x80042444L	ボリュームを含むパックにアクセスできません。オフラインのパックに含まれるすべてのボリュームにはアクセスできません。
VDS_E_FS_NOT_DETERMINED 0x80042593L	既定のファイルシステムを特定できませんでした。

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

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

解説(Remarks)

OEM パーティションを FAT または FAT32 としてフォーマットしても、パーティションの種類は変わりません。NTFS でフォーマットした場合、パーティションの種類は PARTITION_IFS (0x07) に変わります。パーティションの種類については、CREATE_PARTITION_PARAMETERS を参照してください。

BitLocker のボリューム全体の暗号化によって保護されているボリュームに対してこのメソッドを呼び出すと、ユーザーが再び有効にするまで、そのボリュームの BitLocker 暗号化は無効になります。

最小および最大のアロケーションユニットサイズ(クラスターサイズとも呼ばれます)などのファイルシステムの制限の詳細については、NTFS テクニカルリファレンスおよび FAT テクニカルリファレンスを参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IVdsVolumeMF2 "{4DBCEE9A-6343-4651-B85F-5E75D74D983C}"
#usecom global IVdsVolumeMF2 IID_IVdsVolumeMF2 "{}"
#comfunc global IVdsVolumeMF2_GetFileSystemTypeName         3 var
#comfunc global IVdsVolumeMF2_QueryFileSystemFormatSupport  4 var,var
#comfunc global IVdsVolumeMF2_FormatEx                      5 wstr,int,int,wstr,int,int,int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IVdsVolumeMF2 "{4DBCEE9A-6343-4651-B85F-5E75D74D983C}"
#usecom global IVdsVolumeMF2 IID_IVdsVolumeMF2 "{}"
#comfunc global IVdsVolumeMF2_GetFileSystemTypeName         3 sptr
#comfunc global IVdsVolumeMF2_QueryFileSystemFormatSupport  4 sptr,sptr
#comfunc global IVdsVolumeMF2_FormatEx                      5 wstr,int,int,wstr,int,int,int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。