RtlSubtreeSuccessor 関数 (ntddk.h)
RtlSubtreeSuccessor ルーチンは、そのノードにルート化されたサブツリー内の指定されたノードの後続ノードへのポインターを返します。
構文
NTSYSAPI PRTL_SPLAY_LINKS RtlSubtreeSuccessor(
[in] PRTL_SPLAY_LINKS Links
);
パラメーター
[in] Links
ノードへのポインター。 ノードは RtlInitializeSplayLinks を呼び出して初期化されている必要があります。
戻り値
RtlSubtreeSuccessor は 、リンクにあるノードのサブツリー後続処理へのポインターを返します。指定されたノードにサブツリーの後続処理がない場合は NULL を 返します。
注釈
Links のノードに右サブツリーがある場合、そのサブツリーの左端のノードはサブツリーの後続ノードです。
Rtl スプレイ リンク ルーチンの呼び出し元は、スプレイ リンク ツリーへのアクセスを同期する役割を担います。 高速ミューテックスは、この目的で使用する最も効率的な同期メカニズムです。
ツリーが非ページの場合、 RtlSubtreeSuccessor の呼び出し元は IRQL <= DISPATCH_LEVELで実行されている必要があります。 ツリーがページングされている場合、呼び出し元は IRQL < DISPATCH_LEVELで実行されている必要があります。 通常、呼び出し元は IRQL PASSIVE_LEVELで実行されています。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | このルーチンは、Microsoft Windows 2000 以降で使用できます。 |
| 対象プラットフォーム | ユニバーサル |
| Header | ntddk.h (Ntddk.h、Ntifs.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | 「解説」を参照してください。 |