Fonction RtlRealSuccessor (ntddk.h)
La routine RtlRealSuccessor retourne un pointeur vers le successeur du nœud spécifié dans l’arborescence des liens de lecture.
Syntaxe
NTSYSAPI PRTL_SPLAY_LINKS RtlRealSuccessor(
[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
RtlRealSuccessor retourne un pointeur vers le successeur du nœud dans Liens, ou NULL si le nœud n’a pas de successeur.
Remarques
Le successeur réel d’un nœud donné est déterminé comme suit :
- Si le nœud donné a une sous-arborescence droite, le nœud le plus à gauche dans la sous-arborescence droite du nœud dans Liens est le successeur. Notez que RtlSubtreeSuccessor 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 la sous-arborescence gauche, est le successeur.
Les appelants de RtlRealSuccessor 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. |