RtlInitializeSplayLinks 関数 (ntddk.h)

[アーティクル]
02/27/2024

RtlInitializeSplayLinks ルーチンは、splay リンクノードを初期化します。

構文

void RtlInitializeSplayLinks(
  [in] PRTL_SPLAY_LINKS Links
);

パラメーター

[in] Links

初期化された splay リンクノードを格納するには、呼び出し元によって割り当てられたバッファーへのポインター (少なくとも sizeof(RTL_SPLAY_LINK)) である必要があります。

戻り値

なし

解説

すべての splay リンクノード (splay リンクツリーの初期ルートノードを含む) は、 RtlInitializeSplayLinks を呼び出して初期化してから、他の Rtl splay リンクルーチンに渡す必要があります。初期化されたスプレイリンクノード構造は不透明と見なす必要があります。

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

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