FltGetNextExtraCreateParameter 関数 (fltkernel.h)

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

FltGetNextExtraCreateParameter ルーチンは、指定された ECP リスト内の次の (または最初の) 追加の create パラメーターコンテキスト構造 (ECP) へのポインターを返します。

構文

NTSTATUS FLTAPI FltGetNextExtraCreateParameter(
  [in]            PFLT_FILTER Filter,
  [in]            PECP_LIST   EcpList,
  [in, optional]  PVOID       CurrentEcpContext,
  [out, optional] LPGUID      NextEcpType,
  [out, optional] PVOID       *NextEcpContext,
  [out, optional] ULONG       *NextEcpContextSize
);

パラメーター

[in] Filter

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

[in] EcpList

調べる ECP リストへのポインター。

[in, optional] CurrentEcpContext

指定された ECP リスト内の ECP へのオプションのポインター。存在する場合、 FltGetNextExtraCreateParameter はCurrentEcpContext ECP の後に ECP を返します。 CurrentEcpContext が NULL の場合、FltGetNextExtraCreateParameter はリスト内の最初の ECP を返します。

[out, optional] NextEcpType

返された ECP の GUID へのポインターを受け取る省略可能なパラメーター。

[out, optional] NextEcpContext

返された ECP へのポインターを受け取る省略可能なパラメーター。

[out, optional] NextEcpContextSize

返された ECP のサイズをバイト単位で受け取る省略可能なパラメーター。

戻り値

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

リターンコード	説明
STATUS_SUCCESS	EcpList ECP リストに ECP が見つかりました。
STATUS_NOT_FOUND	EcpList ECP リストが空であるか、CurrentEcpContext がリスト内の最後の ECP であり、次の ECP リスト要素はありません)。さらに、 NextEcpContext が NULL に設定され、 NextEcpContextSize が 0 に設定されます。
STATUS_INVALID_PARAMETER	EcpList パラメーターは NULL です。

注釈

このルーチンは、Windows Vista 以降で使用できます。

FltGetNextExtraCreateParameter ルーチンは、非循環方式で ECP リストを処理します。つまり、 CurrentEcpContext パラメーターが指す ECP が ECP リスト内の最後の ECP 要素である場合、リストに "next" ECP はなく、ルーチンはSTATUS_NOT_FOUNDを返します。

要件

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