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 retournée
RtlSubtreeSuccessor retourne un pointeur vers le successeur de la sous-arborescence du nœud dans Liens, ou NULL si le nœud donné n’a pas de successeur de sous-arborescence.
Remarques
Si le nœud sur 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 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 RtlSubtreeSuccessor doivent être en cours d’exécution à IRQL <= DISPATCH_LEVEL si l’arborescence n’est pas paginée. Si l’arborescence est paginée, les appelants doivent être en cours d’exécution au DISPATCH_LEVEL IRQL < . En règle générale, les appelants s’exécutent au PASSIVE_LEVEL IRQL.
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. |