RtlSplay 関数 (ntddk.h)

RtlSplay ルーチンの再調整 ("再生") は、指定されたスプレイリンクの周囲にあるスプレイリンクツリーであり、ツリーの新しいルートをリンクします。

構文

NTSYSAPI PRTL_SPLAY_LINKS RtlSplay(
  [in, out] PRTL_SPLAY_LINKS Links
);

[in, out] Links

再調整されたスプレイリンクツリーのルートノードになるノードへのポインター。ノードは RtlInitializeSplayLinks を呼び出して初期化されている必要があります。

RtlSplay は、ツリーの再調整時に Links ポインターを返します。

L が指定されたリンク、P がその親ノード、G がその祖父母ノードである場合、 RtlSplay は次の図に示す 6 つのパターンのいずれかに従って、スプレイリンクツリーを再調整します。

表示リンクツリーの再調整を示す図。ここで、L は指定されたリンク、P は親ノード、G は祖父母ノードです。

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

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