FltQueryVolumeInformationFile 関数 (fltkernel.h)

[アーティクル]
08/07/2023

FltQueryVolumeInformationFile は 、特定のファイル、ディレクトリ、ストレージデバイス、またはボリュームのボリューム情報を取得します。

構文

NTSTATUS FLTAPI FltQueryVolumeInformationFile(
  [in]            PFLT_INSTANCE        Instance,
  [in]            PFILE_OBJECT         FileObject,
  [out]           PVOID                FsInformation,
  [in]            ULONG                Length,
  [in]            FS_INFORMATION_CLASS FsInformationClass,
  [out, optional] PULONG               LengthReturned
);

パラメーター

[in] Instance

呼び出し元の不透明なインスタンスポインター。このパラメーターは必須であり、 NULL にすることはできません。

[in] FileObject

開いているファイル、ディレクトリ、ストレージデバイス、またはボリュームのファイルオブジェクトポインター。このパラメーターは必須であり、 NULL にすることはできません。

[out] FsInformation

ファイルに関する情報を受け取る呼び出し元によって割り当てられたバッファーへのポインター。 FsInformationClass パラメーターは、情報の種類を指定します。このパラメーターは必須であり、 NULL にすることはできません。

[in] Length

FsInformation バッファーのサイズ (バイト単位)。

[in] FsInformationClass

返されるボリューム情報の種類。次のいずれかになります。

値	意味
FileFsAttributeInformation	ボリュームを担当するファイルシステムに関する属性情報を含むFILE_FS_ATTRIBUTE_INFORMATION構造体を返します。
FileFsControlInformation	ボリュームに関するファイルシステム制御情報を含む FILE_FS_CONTROL_INFORMATION 構造体を返します。
FileFsDeviceInformation	ボリュームのデバイス情報を含む FILE_FS_DEVICE_INFORMATION 構造体を返します。
FileFsDriverPathInformation	指定したドライバーがボリュームの I/O パスにあるかどうかに関する情報を含むFILE_FS_DRIVER_PATH_INFORMATION構造体を返します。呼び出し元は、FltQueryVolumeInformationFile を呼び出す前に、ドライバーの名前を FILE_FS_DRIVER_PATH_INFORMATION 構造体に格納する必要があります。
FileFsFullSizeInformation	ボリュームで使用可能な領域の合計量に関する情報を含むFILE_FS_FULL_SIZE_INFORMATION構造体を返します。
FileFsObjectIdInformation	ボリュームのファイルシステム固有のオブジェクト ID 情報を含むFILE_FS_OBJECTID_INFORMATION構造体を返します。これは、オペレーティングシステムによって割り当てられる (GUID ベースの) 一意のボリューム名と同じではないことに注意してください。
FileFsSizeInformation	呼び出し元スレッドに関連付けられているユーザーが使用できるボリューム上の領域の量に関する情報を含むFILE_FS_SIZE_INFORMATION構造体を返します。
FileFsVolumeInformation	ボリュームラベル、シリアル番号、作成時刻などのボリュームに関する情報を含むFILE_FS_VOLUME_INFORMATIONを返します。
FileFsSectorSizeInformation	ボリュームの物理セクターサイズと論理セクターサイズに関する情報を含むFILE_FS_SECTOR_SIZE_INFORMATION構造体を返します。

[out, optional] LengthReturned

FsInformation バッファーで返される情報のサイズ (バイト単位) を受け取る呼び出し元割り当て変数へのポインター。このパラメーターは省略可能であり、 NULL にすることができます。

戻り値

FltQueryVolumeInformationFile は、次のようなSTATUS_SUCCESSまたは適切な NTSTATUS 値を返します。

リターンコード	説明
STATUS_VOLUME_DISMOUNTED	ボリュームは現在マウントされていません。これはエラーコードです。

注釈

FltQueryVolumeInformationFile は 、特定のファイル、ディレクトリ、ストレージデバイス、またはボリュームのボリューム情報を取得します。

FileObject が直接開いているデバイスを表す場合、FsInformationClass の値として指定できるのは FileFsDeviceInformation だけです。

FltQueryVolumeInformationFile は、特定のファイルシステムでサポートされていないFILE_FS_XXX_INFORMATION 構造体のメンバーで 0 を返します。

要件

要件	値
対象プラットフォーム	ユニバーサル
Header	fltkernel.h (Fltkernel.h を含む)
Library	FltMgr.lib
[DLL]	Fltmgr.sys
IRQL	PASSIVE_LEVEL