FltInitExtraCreateParameterLookasideList 函式（fltkernel.h）

發行項
02/06/2025

FltInitExtraCreateParameterLookasideList 例程會初始化用於配置固定大小的一或多個額外建立參數內容結構（ECP）的頁面或非分頁集區 lookaside 清單。

語法

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 外觀清單標頭結構的指標。對於分頁或非分頁的 lookaside 清單，清單前端結構必須從非分頁集區配置。

[in] Flags

定義集區配置選項。如果 Flags 參數包含FSRTL_ECP_LOOKASIDE_FLAG_NONPAGED_POOL位旗標值，則例程會初始化指定大小的非分頁 ECP 專案外觀清單。否則，例程會初始化指定大小的分頁 ECP 專案外觀清單。

[in] Size

指定 lookaside 清單中所有 ECP 專案的大小，以位元組為單位。

[in] Tag

指定配置 lookaside 清單 ECP 專案時要使用的集區標記。如需集區標籤的詳細資訊，請參閱 ExAllocatePoolWithTag的 Tag 參數。

傳回值

沒有

言論

使用此例程來初始化分頁或非分頁集區外觀清單。使用 FltAllocateExtraCreateParameterFromLookasideList 例程，從 lookaside 清單配置 ECP，以及 FltFreeExtraCreateParameter 例程，將 ECP 緩衝區傳回 lookaside 列表以供回收。

使用 FltDeleteExtraCreateParameterLookasideList 例程釋放 lookaside 列表本身。

驅動程式必須釋放其卸除之前建立的所有 ECP 和外觀清單。

如需搭配驅動程式使用 lookaside 清單的詳細資訊，請參閱使用 Lookaside 清單。

要求

要求	價值
最低支援的用戶端	從 Windows Vista 開始，即可使用 FltInitExtraCreateParameterLookasideList 例程。
目標平臺	普遍
標頭	fltkernel.h （包括 Fltkernel.h）
連結庫	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL