次の方法で共有

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 値は、FltFindExtraCreateParamter ルーチンによって使用され、ECP コンテキスト構造が ECP リストに存在するかどうかを判断します (EcpList パラメーターによって指定されます)。

[out, optional] EcpContext

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

[out, optional] EcpContextSize

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

戻り値

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

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

必要条件

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

関連項目

ECP_LIST

FltAllocateExtraCreateParameterFromLookasideList の

FltCreateFileEx2 を する

FltFreeExtraCreateParameter を する

FltGetEcpListFromCallbackData の

FltInsertExtraCreateParameter の

FltRemoveExtraCreateParameter の

FltSetEcpListIntoCallbackData の

IoCreateFileEx の