次の方法で共有


FltFindExtraCreateParameter 関数 (fltkernel.h)

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 リストに見つからない場合、 EcpContextNULL に設定されます。 呼び出し元によって EcpContextNULL に設定されている場合、このルーチンの戻り値を使用して、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

こちらもご覧ください

ECP_LIST

FltAllocateExtraCreateParameterFromLookasideList

FltCreateFileEx2

FltFreeExtraCreateParameter

FltGetEcpListFromCallbackData

FltInsertExtraCreateParameter

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

IoCreateFileEx