RtlSubtreePredecessor-Funktion (ntddk.h)
Die RtlSubtreePredecessor-Routine gibt einen Zeiger auf den Vorgänger des angegebenen Knotens in der Unterstruktur zurück, die sich auf diesem Knoten befindet.
Syntax
NTSYSAPI PRTL_SPLAY_LINKS RtlSubtreePredecessor(
[in] PRTL_SPLAY_LINKS Links
);
Parameter
[in] Links
Ein Zeiger auf den Knoten. Der Knoten muss durch Aufrufen von RtlInitializeSplayLinks initialisiert worden sein.
Rückgabewert
RtlSubtreePredecessor gibt einen Zeiger auf den Unterstrukturvorläufer des Knotens unter Links oder NULL zurück, wenn der Knoten keinen Unterstruktur-Vorgänger aufweist.
Hinweise
Wenn der Knoten unter Links über eine linke Unterstruktur verfügt, ist der rechtsste Knoten dieser Unterstruktur der Vorgänger der Unterstruktur.
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 RtlSubtreePredecessor müssen unter IRQL <= DISPATCH_LEVEL ausgeführt werden, wenn die Struktur nicht aus der Auslagerung besteht. 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. |