FltFindExtraCreateParameter 関数 (fltkernel.h)

[アーティクル]
08/07/2023

FltFindExtraCreateParameter ルーチンは、特定の ECP リストで特定の型の ECP コンテキスト構造を検索し、見つかった場合は、この構造体へのポインターを返します。

構文

NTSTATUS FLTAPI FltFindExtraCreateParameter(
  [in]            PFLT_FILTER Filter,
  [in]            PECP_LIST   EcpList,
  [in]            LPCGUID     EcpType,
  [out, optional] PVOID       *EcpContext,
  [out, optional] ULONG       *EcpContextSize
);

パラメーター

[in] Filter

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

[in] EcpList

ECP コンテキスト構造を検索する ECP リスト構造へのポインター ( EcpType パラメーターによって指定)。

[in] EcpType

各 ECP コンテキスト構造を一意に識別する GUID へのポインター。この GUID 値は、ECP コンテキスト構造が ECP リストに存在するかどうかを判断するために FltFindExtraCreateParamter ルーチンによって使用されます ( EcpList パラメーターによって指定されます)。

[out, optional] EcpContext

見つかった ECP コンテキスト構造体へのポインターを受け取る省略可能なパラメーター。 ECP コンテキスト構造が ECP リストに見つからない場合、 EcpContext は NULL に設定されます。呼び出し元によって EcpContext が NULL に設定されている場合、このルーチンの戻り値を使用して、ECP コンテキスト構造が ECP リスト内にあるかどうかを判断できます。

[out, optional] EcpContextSize

見つかった ECP コンテキスト構造のサイズをバイト単位で受け取る省略可能なパラメーター。 ECP コンテキスト構造が ECP リストに見つからない場合、 EcpContextSize はゼロに設定されます。

戻り値

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

リターンコード	説明
STATUS_SUCCESS	ECP コンテキスト構造 ( EcpType パラメーターで指定) が ECP リストに見つかりました ( EcpList パラメーターで指定)。
STATUS_NOT_FOUND	ECP コンテキスト構造 ( EcpType パラメーターで指定) が ECP リストに見つかりませんでした ( EcpList パラメーターで指定)。

要件

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