RtlInitializeSplayLinks-Funktion (ntddk.h)

2025-02-07

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.