FltInitExtraCreateParameterLookasideList 関数 (fltkernel.h)
fltInitExtraCreateParameterLookasideList ルーチン は、固定サイズの 1 つ以上の追加の作成パラメーター コンテキスト構造 (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 とルックアサイド リストを解放する必要があります。
ドライバーでルックアサイド リストを使用する方法の詳細については、「ルックアサイド リストの使用 」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | FltInitExtraCreateParameterLookasideList ルーチンは、Windows Vista 以降で使用できます。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | fltkernel.h (Fltkernel.h を含む) |
| ライブラリ | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | <= APC_LEVEL |
関連項目
ExAllocatePoolWithTag の
FltAllocateExtraCreateParameter の
FltAllocateExtraCreateParameterFromLookasideList の
FltAllocateExtraCreateParameterList の
FltCreateFileEx2 を する
FltDeleteExtraCreateParameterLookasideList を する
FltFreeExtraCreateParameter を する
FltFreeExtraCreateParameterList を する
FltGetEcpListFromCallbackData の
FltInsertExtraCreateParameter の
FltRemoveExtraCreateParameter の
FltSetEcpListIntoCallbackData の
IoCreateFileEx の