FsRtlInitExtraCreateParameterLo (List 函式 (ntifs.h)

發行項
02/29/2024

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

[in] Flags

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

[in] Size

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

[in] Tag

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

傳回值

無

備註

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

使用 FsRtlDeleteExtraCreateParameterLo可sideList 例程釋放 lookaside 清單本身。

驅動程式必須在卸除之前釋出他們建立的所有ECP和 lookaside 清單。

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

規格需求

需求	值
最低支援的用戶端	從 Windows Vista 開始，即可使用 FsRtlInitExtraCreateParameterLo在sideList 例程。
目標平台	Universal
標頭	ntifs.h (包含 Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	<= APC_LEVEL