Função RtlSubtreeSuccessor (ntddk.h)
A rotina RtlSubtreeSuccessor retorna um ponteiro para o sucessor do nó especificado dentro da subárvore que está enraizada 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.
Valor de retorno
RtlSubtreeSuccessor retorna um ponteiro para o sucessor da subárvore do nó em Linksou NULL se o nó fornecido não tiver nenhum sucessor de subárvore.
Observações
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 do Rtl rotinas de link de reprodução 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 no 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 PASSIVE_LEVEL IRQL.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Essa rotina está disponível no Microsoft Windows 2000 e posterior. |
| da Plataforma de Destino | Universal |
| cabeçalho | ntddk.h (inclua Ntddk.h, Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | Consulte a seção Comentários. |