RtlRealPredecessor-Funktion (ntddk.h)

Die RtlRealPredecessor-Routine gibt einen Zeiger auf den Vorgänger des angegebenen Knotens in der Wiedergabelinkstruktur zurück.

Syntax

NTSYSAPI PRTL_SPLAY_LINKS RtlRealPredecessor(
  [in] PRTL_SPLAY_LINKS Links
);

Parameter

[in] Links

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

Rückgabewert

RtlRealPredecessor gibt einen Zeiger auf den Vorgänger des Knotens unter Links oder NULL zurück, wenn der Knoten keinen Vorgänger aufweist.

Hinweise

Der Vorgänger eines bestimmten Knotens wird wie folgt bestimmt:

• Wenn der angegebene Knoten über eine linke Unterstruktur verfügt, ist der rechtsste Knoten in der linken Unterstruktur des Knotens unter Links der Vorgänger. Beachten Sie, dass RtlSubtreePredecessor für diesen Fall das gleiche Ergebnis zurückgibt.
• Andernfalls ist der nächste Vorgängerknoten, von dem der angegebene Knoten ein Nachkomme der rechten Unterstruktur ist, der Vorgänger.

Anrufer der Rtl-Splaylinkroutinen sind für die Synchronisierung des Zugriffs auf die Splay-Linkstruktur verantwortlich. Ein schneller Mutex ist der effizienteste Synchronisierungsmechanismus für diesen Zweck.

Aufrufer von RtlRealPredecessor müssen unter IRQL <= DISPATCH_LEVEL ausgeführt werden, wenn die Struktur nicht auspaged 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

RtlRealSuccessor

RtlSplay

RtlSubtreePredecessor