RtlRealSuccessor 函数 (ntddk.h)
RtlRealSuccessor 例程返回指向 splay 链接树中指定节点的后续节点的指针。
语法
NTSYSAPI PRTL_SPLAY_LINKS RtlRealSuccessor(
[in] PRTL_SPLAY_LINKS Links
);
参数
[in] Links
指向节点的指针。 节点必须已通过调用 RtlInitializeSplayLinks 进行初始化。
返回值
RtlRealSuccessor 返回指向 链接处节点的后续节点的指针;如果节点没有后续节点，则返回 NULL 。
注解
给定节点的实际后续节点按如下方式确定：
- 如果给定节点具有右侧子树，则 链接 处节点右子树中最左侧的节点是后续节点。 请注意，对于这种情况， RtlSubtreeSuccessor 返回相同的结果。
- 否则，最近的上级节点（给定节点是左子树后代）是后续节点。
如果树是非分页的， 则 RtlRealSuccessor 的调用方必须在 IRQL <= DISPATCH_LEVEL 运行。 通常，调用方在 IRQL PASSIVE_LEVEL运行。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 此例程在 Microsoft Windows 2000 及更高版本上可用。 |
| 目标平台 | 通用 |
| 标头 | ntddk.h (包括 Ntddk.h、Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | 请参见“备注”部分。 |