FltRequestFileInfoOnCreateCompletion 関数 (fltkernel.h)
ミニフィルターは、ファイルの事前作成中に 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 を呼び出すことによって、ファイル情報を取得できます。 ミニフィルターのパフォーマンスは、通常、後でファイル情報に対してクエリを実行するのではなく、この方法でファイル情報を要求および取得する場合に優れています。
要件
要件 | 値 |
---|---|
Header | fltkernel.h (Fltkernel.h を含む) |