Fonction RtlRealPredecessor (ntddk.h)

La routine RtlRealPredecessor retourne un pointeur vers le prédécesseur du nœud spécifié dans l’arborescence de 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 retournée

RtlRealPredecessor retourne un pointeur vers le prédécesseur du nœud dans Liens, 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 dans 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 des routines de liens de lecture rtl sont responsables de la synchronisation de l’accès à l’arborescence de liens de lecture. Un mutex rapide est le mécanisme de synchronisation le plus efficace à utiliser à cet effet.

Les appelants de RtlRealPredecessor doivent être en cours d’exécution sur IRQL <= DISPATCH_LEVEL si l’arborescence n’a pas de page. En règle générale, les appelants s’exécutent sur irQL PASSIVE_LEVEL.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Cette routine est disponible sur Microsoft Windows 2000 et versions ultérieures.
Plateforme cible Universal
En-tête ntddk.h (inclure Ntddk.h, Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Consultez la section Notes.

Voir aussi

RtlRealSuccessor

RtlSplay

RtlSubtreePredecessor