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