RtlRealPredecessor-Funktion (ntddk.h)

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

Syntax

NTSYSAPI PRTL_SPLAY_LINKS RtlRealPredecessor(
  [in] PRTL_SPLAY_LINKS Links
);

Parameter

[in] Links

Zeigen Sie auf den Knoten. Der Knoten muss durch Aufrufen von RtlInitializeSplayLinksinitialisiert worden sein.

Rückgabewert

RtlRealPredecessor gibt einen Zeiger auf den Vorgänger des Knotens bei Linkszurück oder NULL-, wenn der Knoten keinen Vorgänger hat.

Bemerkungen

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

• Wenn der angegebene Knoten über eine linke Unterstruktur verfügt, ist der äußerst rechte Knoten in der linken Unterstruktur des Knotens bei Verknüpfungen der Vorgänger. Beachten Sie, dass RtlSubtreePredecessor dasselbe Ergebnis für diesen Fall zurückgibt.
• Andernfalls ist der nächste Vorgängerknoten, von dem der angegebene Knoten ein untergeordneter Untergeordneter Knoten ist, der Vorgänger.

Anrufer der Rtl- Wiedergabelinkroutinen sind für die Synchronisierung des Zugriffs auf die Wiedergabelinkstruktur verantwortlich. Ein schneller Mutex ist der effizienteste Synchronisierungsmechanismus, der für diesen Zweck verwendet werden kann.

Anrufer von RtlRealPredecessor- müssen bei IRQL-<= DISPATCH_LEVEL ausgeführt werden, wenn die Struktur nichtpaged ist. In der Regel werden Aufrufer bei IRQL-PASSIVE_LEVEL ausgeführt.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Diese Routine ist unter Microsoft Windows 2000 und höher verfügbar.
Zielplattform-	Universal
Header-	ntddk.h (enthalten Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	Siehe Abschnitt "Hinweise".

Siehe auch

RtlRealSuccessor

RtlSplay-

RtlSubtreePredecessor