Fonction RtlRealPredecessor (ntddk.h)

La routine RtlRealPredecessor retourne un pointeur vers le prédécesseur du nœud spécifié dans l’arborescence des liens de lecture.

Syntaxe

NTSYSAPI PRTL_SPLAY_LINKS RtlRealPredecessor(
  [in] PRTL_SPLAY_LINKS Links
);

Paramètres

[in] Links

Pointeur vers le nœud. Le nœud doit avoir été initialisé en appelant RtlInitializeSplayLinks.

Valeur de retour

RtlRealPredecessor retourne un pointeur vers le prédécesseur du nœud à Links, ou NULL si le nœud n’a pas de prédécesseur.

Remarques

Le prédécesseur d’un nœud donné est déterminé comme suit :

• Si le nœud donné a une sous-arborescence gauche, le nœud le plus à droite dans la sous-arborescence gauche du nœud à Liens est le prédécesseur. Notez que RtlSubtreePredecessor retourne le même résultat pour ce cas.
• Sinon, le nœud ancêtre le plus proche, dont le nœud donné est un descendant de sous-arborescence à droite, est le prédécesseur.

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 RtlRealPredecessor doivent s’exécuter au <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
client minimum pris en charge	Cette routine est disponible sur Microsoft Windows 2000 et versions ultérieures.
plateforme cible	Universel
d’en-tête	ntddk.h (include Ntddk.h, Ntifs.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Voir la section Remarques.

Voir aussi

RtlRealSuccessor

RtlSplay

RtlSubtreePredecessor