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 请参见“备注”部分。

另请参阅

ExInitializeFastMutex

RtlDeleteNoSplay

RtlInsertAsLeftChild

RtlInsertAsRightChild

RtlIsLeftChild

RtlIsRightChild

RtlIsRoot

RtlLeftChild

RtlParent

RtlRealPredecessor

RtlRealSuccessor

RtlRightChild

RtlSplay

RtlSubtreePredecessor

RtlSubtreeSuccessor