FsRtlInitExtraCreateParameterLookasideList 函数 (ntifs.h)

FsRtlInitExtraCreateParameterLookasideList 例程初始化用于分配固定大小的一个或多个额外创建参数上下文结构(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_LISTNPAGED_LOOKASIDE_LIST 外观列表头结构的指针。 对于分页或非分页的查找列表,必须从非分页池分配列表头结构。

[in] Flags

定义池分配选项。 如果 Flags 参数包含FSRTL_ECP_LOOKASIDE_FLAG_NONPAGED_POOL位标志值,FsRtlInitExtraCreateParameterLookasideList 初始化指定大小的非分页 ECP 条目的望边列表。 否则,FsRtlInitExtraCreateParameterLookasideList 初始化指定大小的分页 ECP 条目的外观列表。

[in] Size

指定外观列表中所有 ECP 条目的大小(以字节为单位)。

[in] Tag

指定分配查找列表 ECP 条目时要使用的池标记。 有关池标记的详细信息,请参阅 ExAllocatePoolWithTagTag 参数。

返回值

没有

言论

使用此例程初始化分页或非分页池外观列表。 使用 FsRtlAllocateExtraCreateParameterFromLookasideList 例程从 lookaside 列表中分配 ECP,FsRtlFreeExtraCreateParameter 例程将 ECP 缓冲区返回到查找列表进行回收。

使用 FsRtlDeleteExtraCreateParameterLookasideList 例程释放 lookaside 列表本身。

驱动程序必须在卸载之前释放他们创建的所有 ECP 和外观列表。

有关将 lookaside 列表与驱动程序配合使用的详细信息,请参阅 使用 Lookaside Lists

要求

要求 价值
最低支持的客户端 从 Windows Vista 开始,FsRtlInitExtraCreateParameterLookasideList 例程可用。
目标平台 普遍
标头 ntifs.h (include Ntifs.h)
NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

另请参阅

ECP_LIST

ExAllocatePoolWithTag

FsRtlAllocateExtraCreateParameterFromLookasideList

FsRtlDeleteExtraCreateParameterLookasideList

FsRtlFreeExtraCreateParameter

NPAGED_LOOKASIDE_LIST

PAGED_LOOKASIDE_LIST