FltInitExtraCreateParameterLo一sideList 函式 (fltkernel.h)

發行項
02/26/2024

FltInitExtraCreateParameterLo一sideList 例程會初始化分頁或非分頁集區 lookaside 列表，用於配置一或多個額外的建立參數內容結構， (固定大小的 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 lookaside 清單前端結構的指標。對於分頁或非分頁外觀清單，清單前端結構必須從非分頁集區配置。

[in] Flags

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

[in] Size

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

[in] Tag

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

傳回值

無

備註

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

使用 FltDeleteExtraCreateParameterLo以sideList 例程釋放 lookaside 列表本身。

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

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

規格需求

需求	值
最低支援的用戶端	FltInitExtraCreateParameterLo在List 例程從 Windows Vista 開始可供使用。
目標平台	Universal
標頭	fltkernel.h (包含 Fltkernel.h)
程式庫	FltMgr.lib
Dll	Fltmgr.sys
IRQL	<= APC_LEVEL