Função RtlRealSuccessor (ntddk.h)

A rotina RtlRealSuccessor retorna um ponteiro para o sucessor do nó especificado na árvore de link de reprodução.

Sintaxe

NTSYSAPI PRTL_SPLAY_LINKS RtlRealSuccessor(
  [in] PRTL_SPLAY_LINKS Links
);

Parâmetros

[in] Links

Ponteiro para o nó. O nó deve ter sido inicializado chamando RtlInitializeSplayLinks.

Retornar valor

RtlRealSuccessor retornará um ponteiro para o sucessor do nó em Links ou NULL se o nó não tiver nenhum sucessor.

Comentários

O verdadeiro sucessor de um determinado nó é determinado da seguinte maneira:

  • Se o nó determinado tiver uma subárvore direita, o nó mais à esquerda na subárvore direita do nó em Links será o sucessor. Observe que RtlSubtreeSuccessor retorna o mesmo resultado para esse caso.
  • Caso contrário, o nó ancestral mais próximo, do qual o nó determinado é um descendente de subárvore esquerda, é o sucessor.
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 RtlRealSuccessor devem estar em execução em IRQL <= DISPATCH_LEVEL se a árvore não forpagada. Normalmente, os chamadores estão em execução no PASSIVE_LEVEL IRQL.

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.

Confira também

RtlRealPredecessor

RtlSplay

RtlSubtreeSuccessor