FsRtlInitExtraCreateParameterLookasideList 関数 (ntifs.h)
FsRtlInitExtraCreateParameterLookasideList ルーチンは、固定サイズの 1 つ以上の追加の作成パラメーター コンテキスト構造 (ECP) の割り当てに使用される、ページプールまたは非ページ プールルックアサイド リストを初期化します。
構文
void FsRtlInitExtraCreateParameterLookasideList(
[in, out] PVOID Lookaside,
[in] FSRTL_ECP_LOOKASIDE_FLAGS Flags,
[in] SIZE_T Size,
[in] ULONG Tag
);
パラメーター
[in, out] Lookaside
不透明な PAGED_LOOKASIDE_LIST またはルックアサイドリストヘッド構造 NPAGED_LOOKASIDE_LIST へのポインター。 ページまたは非ページのルックアサイド リストの場合、リスト ヘッド構造は非ページ プールから割り当てる必要があります。
[in] Flags
プールの割り当てオプションを定義します。
Flags パラメーターにFSRTL_ECP_LOOKASIDE_FLAG_NONPAGED_POOLビット フラグ値が含まれている場合、FsRtlInitExtraCreateParameterLookasideList は、指定したサイズの非ページ ECP エントリのルックアサイド リストを初期化。 それ以外の場合は、FsRtlInitExtraCreateParameterLookasideList
[in] Size
ルックアサイド リスト内のすべての ECP エントリのサイズをバイト単位で指定します。
[in] Tag
ルックアサイド・リスト ECP 項目の割り振り時に使用するプール・タグを指定します。 プール タグの詳細については、ExAllocatePoolWithTagの
戻り値
何一つ
備考
このルーチンを使用して、ページ プールのルックアサイド リストまたは非ページ プールルックアサイド リストを初期化します。 FsRtlAllocateExtraCreateParameterFromLookasideList ルーチンを使用してルックアサイド リストから ECP を割り当て、FsRtlFreeExtraCreateParameter ルーチンを使用して、リサイクル用のルックアサイド リストに ECP バッファーを返します。
FsRtlDeleteExtraCreateParameterLookasideList ルーチンを使用して、ルックアサイド リスト自体を解放します。
ドライバーは、アンロードする前に作成するすべての ECP とルックアサイド リストを解放する必要があります。
ドライバーでルックアサイド リストを使用する方法の詳細については、「ルックアサイド リストの使用 」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | FsRtlInitExtraCreateParameterLookasideList ルーチンは、Windows Vista 以降で使用できます。 |
| ターゲット プラットフォーム の |
万国 |
| ヘッダー | ntifs.h (Ntifs.h を含む) |
| ライブラリ | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
関連項目
ExAllocatePoolWithTag の
FsRtlAllocateExtraCreateParameterFromLookasideList