次の方法で共有

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 を することで、ファイル情報を取得できます。 ミニフィルターのパフォーマンスは、通常、後でファイル情報を照会するのではなく、この方法でファイル情報を要求して取得する場合に優れています。

必要条件

要件 価値
ヘッダー fltkernel.h (Fltkernel.h を含む)

関連項目

FLT_CALLBACK_DATA

FltRetrieveFileInfoOnCreateCompletion を する

FltRetrieveFileInfoOnCreateCompletionEx の