Функция RtlSubtreeSuccessor (ntddk.h)
Подпрограмма RtlSubtreeSuccessor возвращает указатель на преемник указанного узла в поддереве, которое коренится на этом узле.
Синтаксис
NTSYSAPI PRTL_SPLAY_LINKS RtlSubtreeSuccessor(
[in] PRTL_SPLAY_LINKS Links
);
Параметры
[in] Links
Указатель на узел. Узел должен быть инициализирован путем вызова RtlInitializeSplayLinks.
Возвращаемое значение
RtlSubtreeSuccessor возвращает указатель на преемник поддеревого узла в links или NULL , если у данного узла нет преемника поддеревого.
Комментарии
Если узел в links имеет правое поддеревое, крайний левый узел этого поддеревого является преемником поддеревого.
Вызывающие подпрограммы ссылок Rtl splay отвечают за синхронизацию доступа к дереву ссылок splay. Быстрый мьютекс является наиболее эффективным механизмом синхронизации, используемым для этой цели.
Вызывающие методы RtlSubtreeSuccessor должны выполняться по адресу IRQL <= DISPATCH_LEVEL, если дерево не загружено. Если дерево отображается на страницы, вызывающие компоненты должны выполняться на DISPATCH_LEVEL IRQL < . Обычно вызывающие абоненты выполняются на PASSIVE_LEVEL IRQL.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Эта подпрограмма доступна в Microsoft Windows 2000 и более поздних версий. |
| Целевая платформа | Универсальное |
| Верхняя часть | ntddk.h (включая Ntddk.h, Ntifs.h) |
| Библиотека | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | См. раздел "Примечания". |