FltInsertExtraCreateParameter 関数 (fltkernel.h)

FltInsertExtraCreateParameter ルーチンは、追加の create パラメーター (ECP) コンテキスト構造を ECP リストに挿入します。

構文

NTSTATUS FLTAPI FltInsertExtraCreateParameter(
  [in]      PFLT_FILTER Filter,
  [in, out] PECP_LIST   EcpList,
  [in, out] PVOID       EcpContext
);

[in] Filter

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

[in, out] EcpList

EcpContext パラメーターによって提供される ECP コンテキスト構造を追加する必要がある ECP リスト構造へのポインター。

[in, out] EcpContext

EcpList パラメーターによって提供される ECP リストに追加される ECP コンテキスト構造へのポインター。

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

リターンコード	説明
STATUS_SUCCESS	指定された ECP コンテキスト構造が、指定された ECP リストに正常に挿入されました。
STATUS_INVALID_PARAMETER	指定された ECP コンテキスト構造は、指定された ECP リストに既に存在します。 ECP リスト挿入のコンテキストでは、2 つの ECP コンテキスト構造が同じ GUID 値を含んでいる場合は同一と見なされます。

FltInsertExtraCreateParameter ルーチンは、指定された ECP リストに挿入される特定の ECP コンテキスト構造が、FltAllocateExtraCreateParameter ルーチンによって以前に割り当てられたことを前提としています。

ECP リストに挿入される各 ECP コンテキスト構造には、一意の GUID 値が必要です。この一意の値は、ECP コンテキスト構造が FltAllocateExtraCreateParameter ルーチンによって割り当てられるときに設定されます。

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