RtlSplay 関数 (ntddk.h)

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

構文

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

[in, out] Links

再調整された splay リンクツリーのルートノードになるノードへのポインター。ノードは、RtlInitializeSplayLinks 呼び出すことによって初期化されている必要があります。

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

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

L が特定のリンク、P がその親ノード、G がその祖父母ノードである、スプレイリンクツリーの再調整を示す図。

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

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