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_LIST 或 NPAGED_LOOKASIDE_LIST 外观列表头结构的指针。 对于分页或非分页的查找列表,必须从非分页池分配列表头结构。
[in] Flags
定义池分配选项。 如果 Flags 参数包含FSRTL_ECP_LOOKASIDE_FLAG_NONPAGED_POOL位标志值,FsRtlInitExtraCreateParameterLookasideList 初始化指定大小的非分页 ECP 条目的望边列表。 否则,FsRtlInitExtraCreateParameterLookasideList 初始化指定大小的分页 ECP 条目的外观列表。
[in] Size
指定外观列表中所有 ECP 条目的大小(以字节为单位)。
[in] Tag
指定分配查找列表 ECP 条目时要使用的池标记。 有关池标记的详细信息,请参阅 ExAllocatePoolWithTag的 Tag 参数。
返回值
没有
言论
使用此例程初始化分页或非分页池外观列表。 使用 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 |
另请参阅
FsRtlAllocateExtraCreateParameterFromLookasideList