Função RtlSubtreeSuccessor (ntddk.h)
A rotina RtlSubtreeSuccessor retorna um ponteiro para o sucessor do nó especificado dentro da subárvore que tem raiz nesse nó.
Sintaxe
NTSYSAPI PRTL_SPLAY_LINKS RtlSubtreeSuccessor(
[in] PRTL_SPLAY_LINKS Links
);
Parâmetros
[in] Links
Um ponteiro para o nó. O nó deve ter sido inicializado chamando RtlInitializeSplayLinks.
Retornar valor
RtlSubtreeSuccessor retornará um ponteiro para o sucessor da subárvore do nó em Links ou NULL se o nó fornecido não tiver nenhum sucessor de subárvore.
Comentários
Se o nó em Links tiver uma subárvore direita, o nó mais à esquerda dessa subárvore será o sucessor da subárvore.
Os chamadores das rotinas de link de reprodução rtl são responsáveis por sincronizar o acesso à árvore de link de reprodução. Um mutex rápido é o mecanismo de sincronização mais eficiente a ser usado para essa finalidade.
Os chamadores de RtlSubtreeSuccessor devem estar em execução em IRQL <= DISPATCH_LEVEL se a árvore não forpagada. Se a árvore for paginada, os chamadores deverão estar em execução no IRQL < DISPATCH_LEVEL. Normalmente, os chamadores estão em execução no IRQL PASSIVE_LEVEL.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Essa rotina está disponível no Microsoft Windows 2000 e posterior. |
| Plataforma de Destino | Universal |
| Cabeçalho | ntddk.h (inclua Ntddk.h, Ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | Consulte a seção Observações. |