FltRemoveExtraCreateParameter 関数 (fltkernel.h)

[アーティクル]
02/06/2025

FltRemoveExtraCreateParameter ルーチンは ECP コンテキスト構造の ECP リストを検索し、見つかった場合は ECP リストからデタッチします。

構文

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

パラメーター

[in] Filter

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

[in, out] EcpList

指定されたリストからデタッチされる ECP コンテキスト構造を含む追加の create パラメーター (ECP) リストへのポインター。

[in] EcpType

リストからデタッチする ECP コンテキスト構造を一意に識別するユーザー定義 GUID へのポインター。

[out] EcpContext

デタッチされた ECP コンテキスト構造体へのポインター。 ECP コンテキスト構造が指定されたリストから正常にデタッチされた場合、このパラメーターはデタッチされた ECP コンテキスト構造を指すよう設定されます。指定された ECP リストに ECP コンテキスト構造が見つからない場合、このパラメーターは NULLに設定されます。

[out, optional] EcpContextSize

デタッチされた ECP コンテキスト構造のサイズを受け取る省略可能なパラメーター。ルーチンの呼び出し時にこのパラメーターが存在する場合、パラメーターはデタッチされた ECP コンテキスト構造のサイズ (バイト単位) を受け取ります。指定された ECP コンテキスト構造が指定された ECP リストに見つからなかった場合、このパラメーターは未定義です。

戻り値

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

リターンコード	形容
STATUS_SUCCESS	指定された ECP コンテキスト構造が、指定された ECP リストから正常にデタッチされました。
STATUS_NOT_FOUND	指定された ECP コンテキスト構造が、指定された ECP リストに見つかりませんでした。

備考

FltRemoveExtraCreateParameter ルーチンは、EcpType パラメーターによって指定された ECP コンテキスト構造について、EcpList パラメーターによって指定された ECP リストを検索します。 ECP コンテキスト構造がリストに存在する場合は、リストからデタッチされ、EcpContext パラメーターが指すように設定され、ルーチンはSTATUS_SUCCESSを返します。 ECP コンテキスト構造がリストに存在しない場合、EcpContext パラメーターは NULL に設定され、ルーチンはSTATUS_NOT_FOUNDを返します。

注このルーチンは、ECP コンテキスト構造のメモリプールを解放しません。 ECP コンテキスト構造を解放するには、まずこのルーチンを呼び出してリストからデタッチしてから、FltFreeExtraCreateParameter ルーチンを呼び出して、ECP コンテキスト構造自体を解放します。

必要条件

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

次の方法で共有

FltRemoveExtraCreateParameter 関数 (fltkernel.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース