Fonction RtlSubtreePredecessor (ntddk.h)

La routine RtlSubtreePredecessor retourne un pointeur vers le prédécesseur du nœud spécifié dans la sous-arborescence qui est enracinée à ce nœud.

Syntaxe

NTSYSAPI PRTL_SPLAY_LINKS RtlSubtreePredecessor(
  [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

RtlSubtreePredecessor retourne un pointeur vers le prédécesseur de la sous-arborescence du nœud dans Liens, ou NULL si le nœud n’a pas de prédécesseur de sous-arborescence.

Remarques

Si le nœud dans Links a une sous-arborescence gauche, le nœud le plus à droite de cette sous-arborescence est le prédécesseur de la sous-arborescence.

Les appelants des routines de liaison splay Rtl 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 RtlSubtreePredecessor doivent être en cours d’exécution à IRQL <= DISPATCH_LEVEL si l’arborescence n’est pas paginée. En règle générale, les appelants s’exécutent à l’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

RtlInitializeSplayLinks

RtlRealPredecessor

RtlSplay

RtlSubtreeSuccessor