FltRemoveExtraCreateParameter 関数 (fltkernel.h)

[アーティクル]
03/05/2024

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 ルーチンは、EcpList パラメーターによって指定された ECP リストで、EcpType パラメーターによって指定された ECP コンテキスト構造を検索します。 ECP コンテキスト構造がリスト内に存在する場合、その構造体はリストからデタッチされ、 EcpContext パラメーターはその構造体を指すように設定され、ルーチンはSTATUS_SUCCESSを返します。 ECP コンテキスト構造がリストに存在しない場合、 EcpContext パラメーターは NULL に設定され、ルーチンはSTATUS_NOT_FOUNDを返します。

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

要件

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