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