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 値が必要です。この一意の値は、FltAllocateExtraCreateParameter ルーチンによって ECP コンテキスト構造が割り当てられるときに設定されます。

要件	価値
サポートされる最小クライアント	このルーチンは、Windows Vista 以降で使用できます。
ターゲットプラットフォームの	万国
ヘッダー	fltkernel.h (Fltkernel.h を含む)
ライブラリ	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL