RtlSubtreeSuccessor-Funktion (ntddk.h)
Die RtlSubtreeSuccessor Routine gibt einen Zeiger auf den Nachfolger des angegebenen Knotens innerhalb der Unterstruktur zurück, die an diesem Knoten verwurzelt ist.
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 RtlInitializeSplayLinksinitialisiert worden sein.
Rückgabewert
RtlSubtreeSuccessor gibt einen Zeiger auf den Unterstrukturnachfolger des Knotens bei Verknüpfungenoder NULL- zurück, wenn der angegebene Knoten keinen Nachfolger der Unterstruktur aufweist.
Bemerkungen
Wenn der Knoten bei Links eine rechte Unterstruktur aufweist, ist der äußerst linke Knoten dieser Unterstruktur der Nachfolger der Unterstruktur.
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.
Aufrufer von RtlSubtreeSuccessor- müssen bei IRQL-<= DISPATCH_LEVEL ausgeführt werden, wenn die Struktur nichtpaged ist. Wenn die Struktur ausgelagert wird, müssen Aufrufer bei IRQL-< DISPATCH_LEVEL ausgeführt werden. 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". |