RtlRealSuccessor 関数 (ntddk.h)

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

構文

NTSYSAPI PRTL_SPLAY_LINKS RtlRealSuccessor(
  [in] PRTL_SPLAY_LINKS Links
);

[in] Links

ノードへのポインター。ノードは、RtlInitializeSplayLinks 呼び出すことによって初期化されている必要があります。

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

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

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

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

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

要件	価値
サポートされる最小クライアント	このルーチンは、Microsoft Windows 2000 以降で使用できます。
ターゲットプラットフォームの	万国
ヘッダー	ntddk.h (Ntddk.h、Ntifs.h を含む)
ライブラリ	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	「解説」セクションを参照してください。