FltSetEcpListIntoCallbackData 関数 (fltkernel.h)

[アーティクル]
02/26/2024

FltSetEcpListIntoCallbackData ルーチンは、追加の create パラメーターコンテキスト構造 (ECP) リストを作成操作 callback-data オブジェクトにアタッチします。

構文

NTSTATUS FLTAPI FltSetEcpListIntoCallbackData(
  [in] PFLT_FILTER        Filter,
       PFLT_CALLBACK_DATA CallbackData,
  [in] PECP_LIST          EcpList
);

パラメーター

[in] Filter

ミニフィルタードライバーへの不透明なフィルターポインター。このポインターはミニフィルタードライバーを一意に識別し、ミニフィルタードライバーが読み込まれる限り一定のままになります。

CallbackData

作成操作を表す 、FLT_CALLBACK_DATA型のコールバックデータオブジェクトへのポインター。

[in] EcpList

コールバックデータオブジェクトにアタッチする 1 つ以上の ECP を含む ECP リストへのポインター。

戻り値

FltSetEcpListIntoCallbackData は、次のいずれかの NTSTATUS 値を返します。

リターンコード	説明
STATUS_SUCCESS	指定された ECP リストが、指定されたコールバックデータオブジェクトに正常にアタッチされました。
STATUS_INVALID_PARAMETER_2	指定されたコールバックデータオブジェクトは、IRP ベースの作成操作ではありません。
STATUS_INVALID_PARAMETER_3	指定されたコールバックデータオブジェクトに ECP リストが既にアタッチされています。

注釈

FltSetEcpListIntoCallbackData ルーチンは、ファイルシステムフィルタースタックの下に追加の create パラメーターを基になるミニフィルタードライバーとレガシフィルタードライバーに渡すメカニズムを提供します。

特定のコールバックデータオブジェクトからアタッチされた ECP リストを取得するには、 FltGetEcpListFromCallbackData ルーチンを使用します。

要件

要件	値
サポートされている最小のクライアント	このルーチンは、Windows Vista 以降で使用できます。
対象プラットフォーム	ユニバーサル
Header	fltkernel.h (Fltkernel.h を含む)
Library	FltMgr.lib
[DLL]	Fltmgr.sys
IRQL	<= APC_LEVEL