Fonction RtlRealSuccessor (ntddk.h)
La routine RtlRealSuccessor retourne un pointeur vers le successeur du nœud spécifié dans l’arborescence de 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 de retour
RtlRealSuccessor retourne un pointeur vers le successeur du nœud à Links, ou NULL si le nœud n’a pas de successeur.
Remarques
Le véritable successeur 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 à 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 sous-arborescence gauche, est le successeur.
Les appelants de rtlRealSuccessor doivent s’exécuter à l'<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. |