Функция RtlRealSuccessor (ntddk.h)

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

Синтаксис

NTSYSAPI PRTL_SPLAY_LINKS RtlRealSuccessor(
  [in] PRTL_SPLAY_LINKS Links
);

Параметры

[in] Links

Указатель на узел. Узел должен быть инициализирован путем вызова RtlInitializeSplayLinks.

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

RtlRealSuccessor возвращает указатель на преемник узла на Linksили NULL, если у узла нет преемника.

Замечания

Реальный преемник данного узла определяется следующим образом:

• Если данный узел имеет правое поддеревное поле, левый узел в правом поддереве узла в Ссылки является преемником. Обратите внимание, что RtlSubtreeSuccessor возвращает тот же результат для этого случая.
• В противном случае ближайший узел-предок, из которого данный узел является левым потомком, является преемником.

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

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Эта подпрограмма доступна в Microsoft Windows 2000 и более поздних версиях.
целевая платформа	Всеобщий
заголовка	ntddk.h (include Ntddk.h, Ntifs.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	См. раздел "Примечания".

См. также

RtlRealPredecessor

RtlSplay

RtlSubtreeSuccessor