Função RtlRealPredecessor (ntddk.h)

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

Sintaxe

NTSYSAPI PRTL_SPLAY_LINKS RtlRealPredecessor(
  [in] PRTL_SPLAY_LINKS Links
);

Parâmetros

[in] Links

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

Valor de retorno

RtlRealPredecessor retorna um ponteiro para o antecessor do nó em Linksou NULL se o nó não tiver nenhum antecessor.

Observações

O predecessor de um determinado nó é determinado da seguinte maneira:

• Se o nó determinado tiver uma subárvore esquerda, o nó mais à direita na subárvore esquerda do nó em Links será o antecessor. Observe que RtlSubtreePredecessor 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árvores direito, é o antecessor.

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 do RtlRealPredecessor devem estar em execução no IRQL <= DISPATCH_LEVEL se a árvore não forpagada. 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.

Consulte também

rtlRealSuccessor

rtlSplay

RtlSubtreePredecessor