RtlSubtreePredecessor-Funktion (ntddk.h)
Die RtlSubtreePredecessor- Routine gibt einen Zeiger auf den Vorgänger des angegebenen Knotens innerhalb der Unterstruktur zurück, die an diesem Knoten verwurzelt ist.
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 RtlInitializeSplayLinksinitialisiert worden sein.
Rückgabewert
RtlSubtreePredecessor gibt einen Zeiger auf den Unterstruktur-Vorgänger des Knotens bei Verknüpfungenzurück oder NULL-, wenn der Knoten keinen Vorgänger der Unterstruktur aufweist.
Bemerkungen
Wenn der Knoten bei Links eine linke Unterstruktur aufweist, ist der äußerst rechte Knoten dieser Unterstruktur der Vorgänger 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 RtlSubtreePredecessor- 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". |