RtlRealSuccessor 函式 (ntddk.h)

RtlRealSuccessor 例程會傳回 splay 連結樹狀結構中指定節點之後續節點的指標。

語法

NTSYSAPI PRTL_SPLAY_LINKS RtlRealSuccessor(
  [in] PRTL_SPLAY_LINKS Links
);

[in] Links

節點的指標。節點必須已藉由呼叫 RtlInitializeSplayLinks 來初始化。

RtlRealSuccessor 會在 Link 傳回節點的後續任務指標，如果節點沒有後續任務，則為 NULL 。

指定節點的實際後續工作會依照下列方式決定：

如果指定的節點有右子樹，則 [連結 ] 節點右子樹中最左邊的節點是後續任務。請注意， RtlSubtreeSuccessor 會傳回此案例的相同結果。
否則，指定節點是左子樹子系的最接近上階節點是後續任務。

Rtl splay 連結例程的呼叫端負責同步存取 splay 連結樹狀結構。快速 Mutex 是用於此用途的最有效率同步處理機制。

RtlRealSuccessor 的呼叫端必須在 IRQL <= DISPATCH_LEVEL，如果樹狀結構為非分頁，則必須執行。通常呼叫端是在 IRQL PASSIVE_LEVEL上執行。

需求	值
最低支援的用戶端	此例程適用於 Microsoft Windows 2000 和更新版本。
目標平台	Universal
標頭	ntddk.h (包含 Ntddk.h、Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	請參閱一節。