FltInitExtraCreateParameterLookasideList 関数 (fltkernel.h)

[アーティクル]
08/07/2023

FltInitExtraCreateParameterLookasideList ルーチンは、固定サイズの 1 つ以上の追加の create パラメーターコンテキスト構造 (ECP) の割り当てに使用されるページプールまたは非ページプールのルックアサイドリストを初期化します。

構文

VOID FLTAPI FltInitExtraCreateParameterLookasideList(
  [in]      PFLT_FILTER               Filter,
  [in, out] PVOID                     Lookaside,
  [in]      FSRTL_ECP_LOOKASIDE_FLAGS Flags,
  [in]      SIZE_T                    Size,
  [in]      ULONG                     Tag
);

パラメーター

[in] Filter

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

[in, out] Lookaside

不透明な PAGED_LOOKASIDE_LIST へのポインター、またはルックアサイドリストヘッド構造 NPAGED_LOOKASIDE_LIST 。ページまたはページ以外のルックアサイドリストの場合は、ページ以外のプールからリストヘッド構造を割り当てる必要があります。

[in] Flags

プール割り当てオプションを定義します。 Flags パラメーターにFSRTL_ECP_LOOKASIDE_FLAG_NONPAGED_POOLビットフラグ値が含まれている場合、ルーチンは、指定したサイズのページ化されていない ECP エントリのルックアサイドリストを初期化します。それ以外の場合、ルーチンは、指定したサイズのページングされた ECP エントリのルックアサイドリストを初期化します。

[in] Size

ルックアサイドリスト内のすべての ECP エントリのサイズをバイト単位で指定します。

[in] Tag

ルックアサイドリスト ECP エントリを割り当てるときに使用するプールタグを指定します。プールタグの詳細については、ExAllocatePoolWithTag の Tag パラメーターを参照してください。

戻り値

なし

解説

このルーチンを使用して、ページプールまたは非ページプールのルックアサイドリストを初期化します。 FltAllocateExtraCreateParameterFromLookasideList ルーチンを使用してルックアサイドリストから ECP を割り当て、FltFreeExtraCreateParameter ルーチンを使用して ECP バッファーをリサイクル用のルックアサイドリストに返します。

FltDeleteExtraCreateParameterLookasideList ルーチンを使用して、ルックアサイドリスト自体を解放します。

ドライバーは、アンロードする前に作成したすべての ECP とルックアサイドリストを解放する必要があります。

ドライバーでルックアサイドリストを使用する方法の詳細については、「Lookaside Listsの使用」を参照してください。

要件

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