Fonction RtlSubtreeSuccessor (ntddk.h)
La routine RtlSubtreeSuccessor retourne un pointeur vers le successeur du nœud spécifié dans la sous-arborescence qui est enracinée à ce nœud.
Syntaxe
NTSYSAPI PRTL_SPLAY_LINKS RtlSubtreeSuccessor(
[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
RtlSubtreeSuccessor retourne un pointeur vers le sous-arbre successeur du nœud à Links, ou NULL si le nœud donné n’a pas de successeur de sous-arborescence.
Remarques
Si le nœud à Links a une sous-arborescence droite, le nœud le plus à gauche de cette sous-arborescence est le successeur 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 RtlSubtreeSuccessor doivent s’exécuter au <IRQL = DISPATCH_LEVEL si l’arborescence n’est pas paginée. Si l’arborescence est paginée, les appelants doivent s’exécuter au < DISPATCH_LEVEL IRQL. 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. |