RtlInitializeSplayLinks-Funktion (ntddk.h)
Die RtlInitializeSplayLinks Routine initialisiert einen Wiedergabelinkknoten.
Syntax
void RtlInitializeSplayLinks(
[in] PRTL_SPLAY_LINKS Links
);
Parameter
[in] Links
Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der mindestens Sizeof(RTL_SPLAY_LINK)sein muss, um den initialisierten Verknüpfungsknoten für die Wiedergabe zu enthalten.
Rückgabewert
Nichts
Bemerkungen
Jeder Splay-Linkknoten, einschließlich des ursprünglichen Stammknotens der Verknüpfungsstruktur für die Wiedergabe, muss initialisiert werden, indem RtlInitializeSplayLinks aufgerufen wird, bevor er an eine andere Rtl- Wiedergabelinkroutine übergeben wird. Die initialisierte Struktur des Verknüpfungsknotens für die Wiedergabe sollte als undurchsichtig betrachtet werden.
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 RtlInitializeSplayLinks- müssen bei IRQL-<= DISPATCH_LEVEL ausgeführt werden, wenn der Speicher bei Links nicht seitenlos ist. In der Regel werden Aufrufer bei IRQL-PASSIVE_LEVEL ausgeführt.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform- | Desktop |
Header- | ntddk.h (enthalten Ntddk.h, Ntifs.h) |
IRQL- | Siehe Abschnitt "Hinweise". |