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. |