次の方法で共有


FsRtlInitExtraCreateParameterLookasideList 関数 (ntifs.h)

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 エントリを割り当てるときに使用するプール タグを指定します。 プール タグの詳細については、「ExAllocatePoolWithTagTag パラメーター」を参照してください。

戻り値

なし

解説

このルーチンを使用して、ページ プールのルックアサイド リストまたは非ページ プールルックアサイド リストを初期化します。 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

こちらもご覧ください

ECP_LIST

ExAllocatePoolWithTag

FsRtlAllocateExtraCreateParameterFromLookasideList

FsRtlDeleteExtraCreateParameterLookasideList

FsRtlFreeExtraCreateParameter

NPAGED_LOOKASIDE_LIST

PAGED_LOOKASIDE_LIST