RtlInsertAsRightChild-Funktion (ntddk.h)

Artikel
02/07/2025

Die RtlInsertAsRightChild Routine fügt einen bestimmten Wiedergabelink als rechtes untergeordnetes Element eines bestimmten Knotens in dieser Struktur ein.

Syntax

void RtlInsertAsRightChild(
  [in] PRTL_SPLAY_LINKS ParentLinks,
  [in] PRTL_SPLAY_LINKS ChildLinks
);

Parameter

[in] ParentLinks

Zeigen Sie auf den Knoten in der Struktur, in der ChildLinks- als das rechte untergeordnete Element eingefügt werden soll.

[in] ChildLinks

Zeigen Sie auf den Wiedergabelinkknoten, der in die Struktur eingefügt werden soll. Der Knoten muss durch Aufrufen von RtlInitializeSplayLinksinitialisiert worden sein.

Rückgabewert

Nichts

Bemerkungen

Anrufer von RtlInsertAsRightChild sind für die Erfüllung der folgenden Kriterien verantwortlich:

Der Knoten bei ParentLinks darf kein untergeordnetes Element haben.
Ein Aufrufer kann ermitteln, ob der Knoten bereits über ein richtiges untergeordnetes Element verfügt, indem er RtlRightChildaufruft. Wenn RtlRightChildNULL-zurückgibt, ist ParentLinks ein gültiger Parameter für RtlInsertAsRightChild.
Der Knoten bei ChildLinks- darf kein übergeordnetes Element haben.
Ein Aufrufer kann ermitteln, ob dieser Knoten bereits über ein übergeordnetes Element verfügt, indem RtlIsRoot- oder RtlParent-aufgerufen wird. Wenn RtlIsRoot-TRUE- zurückgibt, wenn mit ChildLinksaufgerufen wird, ist ChildLinks ein gültiger Parameter für RtlInsertAsRightChild. Wenn RtlParent einen entsprechenden Zeiger auf ChildLinkszurückgibt, ist ChildLinks auch ein gültiger Parameter für RtlInsertAsRightChild.

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.

Anrufer von RtlInsertAsRightChild müssen bei IRQL-<= DISPATCH_LEVEL ausgeführt werden, wenn die Verknüpfungsstruktur für die Wiedergabe und ChildLinks Knoten nicht seitenlos sind. In der Regel werden Aufrufer bei IRQL-PASSIVE_LEVEL ausgeführt.