RtlRealSuccessor 関数 (ntddk.h)

RtlRealSuccessor ルーチンは、スプレイリンクツリー内の指定されたノードの後続ノードへのポインターを返します。

構文

NTSYSAPI PRTL_SPLAY_LINKS RtlRealSuccessor(
  [in] PRTL_SPLAY_LINKS Links
);

[in] Links

ノードへのポインター。ノードは RtlInitializeSplayLinks を呼び出して初期化されている必要があります。

RtlRealSuccessor は 、リンクにあるノードの後続処理へのポインターを返します。ノードに後続処理がない場合は NULL を 返します。

特定のノードの実際の後続処理は、次のように決定されます。

指定されたノードに右サブツリーがある場合、 Links にあるノードの右サブツリーの左端のノードが後続ノードになります。 RtlSubtreeSuccessor は、この場合と同じ結果を返します。
それ以外の場合、指定されたノードが左サブツリーの子孫である最も近い先祖ノードが後続ノードになります。

Rtl スプレイリンクルーチンの呼び出し元は、スプレイリンクツリーへのアクセスを同期する役割を担います。高速ミューテックスは、この目的で使用する最も効率的な同期メカニズムです。

ツリーが非ページの場合、 RtlRealSuccessor の呼び出し元は IRQL <= DISPATCH_LEVELで実行されている必要があります。通常、呼び出し元は IRQL PASSIVE_LEVELで実行されています。

要件	値
サポートされている最小のクライアント	このルーチンは、Microsoft Windows 2000 以降で使用できます。
対象プラットフォーム	ユニバーサル
Header	ntddk.h (Ntddk.h、Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	「解説」を参照してください。