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.

Retornar valor

RtlRealPredecessor retornará um ponteiro para o antecessor do nó em Links ou NULL se o nó não tiver nenhum predecessor.

Comentários

O antecessor 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 direita, é o antecessor.
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 RtlRealPredecessor devem estar em execução em IRQL <= DISPATCH_LEVEL se a árvore não forpagada. 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.

Confira também

RtlRealSuccessor

RtlSplay

RtlSubtreePredecessor