Поделиться через


Макрос RtlLeftChild (ntddk.h)

Подпрограмма RtlLeftChild возвращает указатель на левый дочерний элемент указанного узла канала воспроизведения.

Синтаксис

void RtlLeftChild(
  [in]  Links
);

Параметры

[in] Links

Указатель на узел, левый дочерний объект которого должен быть возвращен. Узел должен быть инициализирован путем вызова RtlInitializeSplayLinks.

Возвращаемое значение

Никакой

Замечания

RtlLeftChild возвращает указатель на левый дочерний элемент узла в links или возвращает значение NULL, если указанный узел не имеет левого дочернего элемента.

RtlLeftChild можно вызывать многократно в сочетании с RtlParent и RtlRightChild для прогулки по дереву ссылок splay.

Вызывающие Rtl подпрограммы связи splay отвечают за синхронизацию доступа к дереву ссылок splay. Быстрый мьютекс — это наиболее эффективный механизм синхронизации, используемый для этой цели.

Вызывающие RtlLeftChild должны выполняться в IRQL <= DISPATCH_LEVEL, если дерево не покрыто. Обычно вызывающие элементы выполняются в IRQL PASSIVE_LEVEL.

Требования

Требование Ценность
целевая платформа Настольный
заголовка ntddk.h (include Ntddk.h, Ntifs.h)
IRQL См. раздел "Примечания".

См. также

RtlInitializeSplayLinks

RtlInsertAsLeftChild

RtlParent

RtlRightChild