RtlSubtreePredecessor, fonction (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 de retour
RtlSubtreePredecessor retourne un pointeur vers le prédécesseur de la sous-arborescence du nœud à Links, ou NULL si le nœud n’a pas de prédécesseur de sous-arborescence.
Remarques
Si le nœud à 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 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 RtlSubtreePredecessor doivent s’exécuter au <IRQL = DISPATCH_LEVEL si l’arborescence n’est pas paginée. 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. |