RtlIsLeftChild マクロ (ntddk.h)

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

RtlIsLeftChild ルーチンは、特定のスプレイリンクが、スプレイリンクツリー内のノードの左側の子であるかどうかを判断します。

構文

void RtlIsLeftChild(
  [in]  Links
);

パラメーター

[in] Links

ノードへのポインター。ノードは RtlInitializeSplayLinks を呼び出して初期化されている必要があります。

戻り値

なし

解説

RtlIsLeftChild は、Links の指定されたノードが親ノードの左の子である場合は TRUE を返し、それ以外の場合は FALSE を返します。

Links の特定のノードには、ツリー内に親ノードが必要です。呼び出し元は、このノードに RtlIsRoot を持つ親があるかどうかを判断できます。 RtlIsRoot がFALSE を返す場合、Links は RtlIsLeftChild に対する有効なパラメーターです。

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

RtlIsLeftChild の呼び出し元は、splay リンクツリーが非ページの場合、IRQL <= DISPATCH_LEVEL で実行できます。通常、呼び出し元は IRQL PASSIVE_LEVELで実行されています。