ホーム › Storage.VirtualDiskService › IVdsDiskPartitionMF

IVdsDiskPartitionMF

COM

📘 Microsoft Learn (日本語) · English

IID538684e0-ba3d-4bc0-aca9-164aff85c2a9継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

パーティションに対してファイルシステム管理操作を実行するためのメソッドを提供します。

メソッド 4

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

vtbl 3 HRESULT GetPartitionFileSystemProperties(ULONGLONG ullOffset, VDS_FILE_SYSTEM_PROP* pFileSystemProp)

指定したバイトオフセットのディスク上のパーティションにあるファイルシステムのプロパティ詳細を返します。

ullOffset	ULONGLONG	in	ディスクの先頭からのパーティションのバイトオフセット。このオフセットはパーティションの開始位置のオフセットである必要があります。
pFileSystemProp	VDS_FILE_SYSTEM_PROP*	out	正常に完了すると、パーティション上のファイルシステムボリュームのプロパティを受け取る VDS_FILE_SYSTEM_PROP 構造体へのポインター。

戻り値

このメソッドは、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_MISSING_DISK 0x80042454L	ディスクが見つかりません。
VDS_E_OBJECT_NOT_FOUND 0x80042405L	パーティションが存在しません。
VDS_E_PARTITION_NOT_OEM 0x8004256FL	この操作は OEM 以外のパーティションではサポートされていません。

vtbl 4 HRESULT GetPartitionFileSystemTypeName(ULONGLONG ullOffset, LPWSTR* ppwszFileSystemTypeName)

指定したバイトオフセットのディスク上のパーティションにあるファイルシステムの名前を取得します。

ullOffset	ULONGLONG	in	ディスクの先頭からのパーティションのバイトオフセット。このオフセットはパーティションの開始位置のオフセットである必要があります。
ppwszFileSystemTypeName	LPWSTR*	out	正常に完了すると、ファイルシステム名を格納した null 終端の Unicode 文字列を受け取るポインター。

戻り値

リターンコード/値	説明
S_OK	メソッドは正常に完了しました。
VDS_E_BAD_PROVIDER_DATA 0x80042441L	この値はプロバイダーエラーを示します。操作は中止されます。
VDS_E_DISK_REMOVEABLE 0x8004255AL	この操作はリムーバブルメディアではサポートされていません。
VDS_E_MISSING_DISK 0x80042454L	ディスクが見つかりません。
VDS_E_OBJECT_NOT_FOUND 0x80042405L	パーティションが存在しません。
VDS_E_PARTITION_NOT_OEM 0x8004256FL	この操作は OEM 以外のパーティションではサポートされていません。

vtbl 5 HRESULT QueryPartitionFileSystemFormatSupport(ULONGLONG ullOffset, VDS_FILE_SYSTEM_FORMAT_SUPPORT_PROP** ppFileSystemSupportProps, INT* plNumberOfFileSystems)

指定したバイトオフセットのディスク上のパーティションをフォーマットする際にサポートされるファイルシステムのプロパティを取得します。

ullOffset	ULONGLONG	in	ディスクの先頭からのパーティションのバイトオフセット。このオフセットはパーティションの開始位置のオフセットである必要があります。
ppFileSystemSupportProps	VDS_FILE_SYSTEM_FORMAT_SUPPORT_PROP**	out	呼び出し元から渡される VDS_FILE_SYSTEM_FORMAT_SUPPORT_PROP 構造体の配列へのポインター。正常に完了すると、この配列にサポートされるファイルシステムのプロパティに関する情報が格納されます。呼び出し元は、 CoTaskMemFree 関数を使用してこの配列を解放する必要があります。
plNumberOfFileSystems	INT*	out	正常に完了すると、ppFileSystemSupportProps パラメーターの要素の総数を受け取る変数へのポインター。

戻り値

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

vtbl 6 HRESULT FormatPartitionEx(ULONGLONG ullOffset, LPWSTR pwszFileSystemTypeName, WORD usFileSystemRevision, DWORD ulDesiredUnitAllocationSize, LPWSTR pwszLabel, BOOL bForce, BOOL bQuickFormat, BOOL bEnableCompression, IVdsAsync** ppAsync)

既存の OEM、ESP、または不明なパーティションをフォーマットします。(IVdsDiskPartitionMF.FormatPartitionEx)

ullOffset	ULONGLONG	in	ディスクの先頭からのパーティションのバイトオフセット。このオフセットはパーティションの開始位置のオフセットである必要があります。
pwszFileSystemTypeName	LPWSTR	in	パーティションのフォーマットに使用するファイルシステムの名前を格納した NULL 終端の Unicode 文字列。NULL、または次のいずれかである必要があります: "NTFS"、"FAT"、"FAT32"、"UDF"、"EXFAT"。このパラメーターが NULL の場合、既定値が使用されます。
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	ボリュームは正常にパーティション分割されました。
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	ボリュームサイズが小さすぎるため、フォーマットできません。

解説(Remarks)

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

このメソッドは、リムーバブルメディアのフォーマットには使用できません。

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

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

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IVdsDiskPartitionMF "{538684E0-BA3D-4BC0-ACA9-164AFF85C2A9}"
#usecom global IVdsDiskPartitionMF IID_IVdsDiskPartitionMF "{}"
#comfunc global IVdsDiskPartitionMF_GetPartitionFileSystemProperties       3 int64,var
#comfunc global IVdsDiskPartitionMF_GetPartitionFileSystemTypeName         4 int64,var
#comfunc global IVdsDiskPartitionMF_QueryPartitionFileSystemFormatSupport  5 int64,var,var
#comfunc global IVdsDiskPartitionMF_FormatPartitionEx                      6 int64,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_IVdsDiskPartitionMF "{538684E0-BA3D-4BC0-ACA9-164AFF85C2A9}"
#usecom global IVdsDiskPartitionMF IID_IVdsDiskPartitionMF "{}"
#comfunc global IVdsDiskPartitionMF_GetPartitionFileSystemProperties       3 int64,sptr
#comfunc global IVdsDiskPartitionMF_GetPartitionFileSystemTypeName         4 int64,sptr
#comfunc global IVdsDiskPartitionMF_QueryPartitionFileSystemFormatSupport  5 int64,sptr,sptr
#comfunc global IVdsDiskPartitionMF_FormatPartitionEx                      6 int64,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 指定が可能。