Macro RtlParent (ntddk.h)
La routine RtlParent retourne un pointeur vers le parent du nœud spécifié dans une arborescence de liens de lecture.
Syntaxe
void RtlParent(
[in] Links
);
Paramètres
[in] Links
Pointeur vers le nœud. Le nœud doit avoir été initialisé en appelant RtlInitializeSplayLinks.
Valeur de retour
Aucun
Remarques
RtlParent retourne un pointeur vers le parent du nœud sur Links, ou retourne le pointeur Liens si le nœud donné est le nœud racine de l’arborescence.
RtlParent peut être appelée à plusieurs reprises conjointement avec RtlLeftChild 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 RtlParent doivent s’exécuter à l'<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. |