FsRtlInitExtraCreateParameterLookasideList 関数 (ntifs.h)

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

FsRtlInitExtraCreateParameterLookasideList ルーチンは、固定サイズの 1 つ以上の追加の create パラメーターコンテキスト構造 (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 は 、指定したサイズのページ ECP エントリのルックアサイドリストを初期化します。

[in] Size

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

[in] Tag

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

戻り値

なし

解説

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

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

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

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

要件

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