RtlRealSuccessor-Funktion (ntddk.h)

Die RtlRealSuccessor-Routine gibt einen Zeiger auf den Nachfolger des angegebenen Knotens in der Wiedergabelinkstruktur zurück.

Syntax

NTSYSAPI PRTL_SPLAY_LINKS RtlRealSuccessor(
  [in] PRTL_SPLAY_LINKS Links
);

Parameter

[in] Links

Zeiger auf den Knoten. Der Knoten muss durch Aufrufen von RtlInitializeSplayLinks initialisiert worden sein.

Rückgabewert

RtlRealSuccessor gibt einen Zeiger auf den Nachfolger des Knotens unter Links oder NULL zurück, wenn der Knoten keinen Nachfolger hat.

Hinweise

Der tatsächliche Nachfolger eines bestimmten Knotens wird wie folgt bestimmt:

  • Wenn der angegebene Knoten über eine rechte Unterstruktur verfügt, ist der linke Knoten in der rechten Unterstruktur des Knotens unter Links der Nachfolger. Beachten Sie, dass RtlSubtreeSuccessor für diesen Fall das gleiche Ergebnis zurückgibt.
  • Andernfalls ist der nächste Vorgängerknoten, von dem der angegebene Knoten ein nachfolger von links untergeordneter Struktur ist, der Nachfolger.
Aufrufer der Rtl-Splaylinkroutinen sind für die Synchronisierung des Zugriffs auf die Splay-Linkstruktur verantwortlich. Ein schneller Mutex ist der effizienteste Synchronisierungsmechanismus, der für diesen Zweck verwendet werden kann.

Aufrufer von RtlRealSuccessor müssen unter IRQL <= DISPATCH_LEVEL ausgeführt werden, wenn die Struktur nicht ausseiten ist. In der Regel werden Aufrufer am IRQL-PASSIVE_LEVEL ausgeführt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Diese Routine ist unter Microsoft Windows 2000 und höher verfügbar.
Zielplattform Universell
Header ntddk.h (include Ntddk.h, Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Weitere Informationen finden Sie im Abschnitt mit den Hinweisen.

Weitere Informationen

RtlRealPredecessor

RtlSplay

RtlSubtreeSuccessor