RtlSubtreeSuccessor-Funktion (ntddk.h)
Die RtlSubtreeSuccessor-Routine gibt einen Zeiger auf den Nachfolger des angegebenen Knotens in der Unterstruktur zurück, die sich auf diesem Knoten befindet.
Syntax
NTSYSAPI PRTL_SPLAY_LINKS RtlSubtreeSuccessor(
[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
RtlSubtreeSuccessor gibt einen Zeiger auf den Unterstrukturnachfolger des Knotens unter Links oder NULL zurück, wenn der angegebene Knoten keinen Nachfolger der Unterstruktur aufweist.
Hinweise
Wenn der Knoten unter Links über eine rechte Unterstruktur verfügt, ist der linke Knoten dieser Unterstruktur der Nachfolger 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 RtlSubtreeSuccessor müssen unter IRQL <= DISPATCH_LEVEL ausgeführt werden, wenn die Struktur nicht aus der Auslagerung besteht. Wenn die Struktur ausgelagert ist, müssen Aufrufer im IRQL-DISPATCH_LEVEL < ausgeführt werden. In der Regel werden Aufrufer im 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. |