FltRequestFileInfoOnCreateCompletion 関数 (fltkernel.h)

[アーティクル]
05/23/2024

ミニフィルターは、ファイルの事前作成中に FltRequestFileInfoOnCreateCompletion を呼び出して、作成後の取得のためにファイル情報をファイルシステムに格納するよう要求します。

構文

NTSTATUS FLTAPI FltRequestFileInfoOnCreateCompletion(
  PFLT_FILTER        Filter,
  PFLT_CALLBACK_DATA Data,
  ULONG              InfoClassFlags
);

パラメーター

Filter

ミニフィルタードライバーを一意に識別する不透明なフィルターポインター。

Data

I/O 作成操作を表す FLT_CALLBACK_DATA コールバックデータへのポインター。

InfoClassFlags

作成後の取得のためにファイルシステムが格納する必要があるファイル情報の種類を示すフラグビットマスク。次のフラグを任意に組み合わせて使用できます。

フラグ	説明
QoCFileStatInformation (0x00000001)	設定した場合、ファイルシステムはファイル統計情報を取得用のQUERY_ON_CREATE_FILE_STAT_INFORMATION 構造に格納します。
QoCFileLxInformation (0x00000002)	設定すると、ファイルシステムは、拡張 Linux に似た情報を取得用の QUERY_ON_CREATE_FILE_LX_INFORMATION 構造に格納します。
QoCFileEaInformation (0x00000004)	設定されている場合、ファイルシステムは、取得のために拡張属性 (EA) をQUERY_ON_CREATE_EA_INFORMATION 構造体に格納します。
QoCFileUsnInformation (0x00000008)	設定されている場合、ファイルシステムは取得用の QUERY_ON_CREATE_USN_INFORMATION 構造体に USN 情報を格納します。

戻り値

FltRequestFileInfoOnCreateCompletion は、次のいずれかの値を返すことができます。

リターンコード	説明
STATUS_SUCCESS	ファイルシステムは、要求されたファイル情報を正常に格納しました。
STATUS_INSUFFICIENT_RESOURCES	FltRequestFileInfoOnCreateCompletion は、要求されたファイル情報を格納するための十分なメモリを割り当てることができませんでした。
STATUS_INVALID_PARAMETER_2	指定されたコールバックデータオブジェクトは、IRP ベースの作成操作ではありません。

注釈

ミニフィルターは、作成後に FltRetrieveFileInfoOnCreateCompletionEx または FltRetrieveFileInfoOnCreateCompletion を呼び出すことによって、ファイル情報を取得できます。ミニフィルターのパフォーマンスは、通常、後でファイル情報に対してクエリを実行するのではなく、この方法でファイル情報を要求および取得する場合に優れています。