RtlRightChild - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers 
#ifndef _NTRTL_H

#define RtlRightChild(Links) ((PRTL_SPLAY_LINKS)(Links)->RightChild)

#endif

View code on GitHub
// ntddk.h

void RtlRightChild(
  [in] Links
);
View the official Windows Driver Kit DDI reference

NtDoc

This macro is documented in Windows Driver Kit.

Edit description on GitHub

Windows Driver Kit DDI reference (nf-ntddk-rtlrightchild)

RtlRightChild macro

Description

The RtlRightChild routine returns a pointer to the right child of the specified splay link node.

Parameters

Pointer to the node whose right child is to be returned. The node must have been initialized by calling RtlInitializeSplayLinks.

Remarks

RtlRightChild returns a pointer to the right child of the node at Links, or it returns NULL if the specified node has no right child.

RtlRightChild can be called repeatedly in conjunction with RtlParent and RtlLeftChild to walk a splay link tree.

Callers of the Rtl splay link routines are responsible for synchronizing access to the splay link tree. A fast mutex is the most efficient synchronization mechanism to use for this purpose.

Callers of RtlRightChild must be running at IRQL <= DISPATCH_LEVEL if the tree is nonpaged. Usually, callers are running at IRQL PASSIVE_LEVEL.

See also

RtlInitializeSplayLinks

RtlInsertAsRightChild

RtlLeftChild

RtlParent

View the official Windows Driver Kit DDI reference

Edit description on GitHub