RtlInitializeSplayLinks 函数 (ntddk.h)
RtlInitializeSplayLinks 例程初始化 splay 链接节点。
语法
void RtlInitializeSplayLinks(
[in] PRTL_SPLAY_LINKS Links
);
参数
[in] Links
指向调用方分配的缓冲区的指针,该 缓冲区的大小 必须至少为 (RTL_SPLAY_LINK) ,才能包含初始化的 splay 链接节点。
返回值
无
备注
每个 splay 链接节点(包括 splay 链接树的初始根节点)都必须通过调用 RtlInitializeSplayLinks 进行初始化,然后才能将其传递给任何其他 Rtl splay 链接例程。 应将初始化的 splay 链接节点结构视为不透明。
Rtl splay 链接例程的调用方负责同步对 splay 链接树的访问。 快速互斥体是用于此目的的最有效同步机制。
如果链接处的内存未分页,则 RtlInitializeSplayLinks 的调用方必须在 IRQL <= DISPATCH_LEVEL 运行。 通常,调用方在 IRQL PASSIVE_LEVEL运行。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | ntddk.h (包括 Ntddk.h、Ntifs.h) |
IRQL | 请参见“备注”部分。 |