Partager via


Macro RtlLeftChild (ntddk.h)

La routine RtlLeftChild retourne un pointeur vers l’enfant gauche du nœud de lien de lecture spécifié.

Syntaxe

void RtlLeftChild(
  [in]  Links
);

Paramètres

[in] Links

Pointeur vers le nœud dont l’enfant gauche doit être retourné. Le nœud doit avoir été initialisé en appelant RtlInitializeSplayLinks.

Valeur de retour

Aucun

Remarques

RtlLeftChild retourne un pointeur vers l’enfant gauche du nœud sur Links, ou retourne NULL si le nœud spécifié n’a pas d’enfant gauche.

RtlLeftChild peut être appelée à plusieurs reprises conjointement avec RtlParent et RtlRightChild pour parcourir un arbre de lien de jeu.

Les appelants du Rtl routines de liaison de lecture sont responsables de la synchronisation de l’accès à l’arborescence des liens de lecture. Un mutex rapide est le mécanisme de synchronisation le plus efficace à utiliser à cet effet.

Les appelants de RtlLeftChild doivent s’exécuter à IRQL <= DISPATCH_LEVEL si l’arborescence n’est pas paginé. En règle générale, les appelants s’exécutent au PASSIVE_LEVEL IRQL.

Exigences

Exigence Valeur
plateforme cible Bureau
d’en-tête ntddk.h (include Ntddk.h, Ntifs.h)
IRQL Voir la section Remarques.

Voir aussi

RtlInitializeSplayLinks

RtlInsertAsLeftChild

RtlParent

RtlRightChild