Share via


FltPrepareToReuseEcp 関数 (fltkernel.h)

FltPrepareToReuseEcp ルーチンは、追加の create パラメーター (ECP) コンテキスト構造をリセットし、再利用できるように準備します。

構文

VOID FLTAPI FltPrepareToReuseEcp(
  [in] PFLT_FILTER Filter,
  [in] PVOID       EcpContext
);

パラメーター

[in] Filter

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

[in] EcpContext

再利用の準備を行う ECP へのポインター。

戻り値

[なし] :

解説

FltPrepareToReuseEcp を使用すると、前の作成要求で使用された ECP を再利用できます。 これにより、同じ情報を使用して新しい ECP を初期化する必要がなくなります。

ECP のターゲットは 、FltAcknowledgeEcp を使用して ECP を確認済みとしてマークします。 これは、ECP が検出されて処理されたことを示します。 再解析の処理中など、以前に確認された ECP を再利用するために、ドライバーは FltPrepareToReuseEcp を使用して、別の作成要求で送信する前に、確認済みの状態を ECP からクリアできます。

要件

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

こちらもご覧ください

ECP_LIST

FltGetEcpListFromCallbackData

FltIsEcpAcknowledged

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

FltlInsertExtraCreateParameter