Función RtlRealSuccessor (ntddk.h)

La rutina RtlRealSuccessor devuelve un puntero al sucesor del nodo especificado en el árbol de vínculos de reproducción.

Sintaxis

NTSYSAPI PRTL_SPLAY_LINKS RtlRealSuccessor(
  [in] PRTL_SPLAY_LINKS Links
);

Parámetros

[in] Links

Puntero al nodo. El nodo debe haberse inicializado llamando a RtlInitializeSplayLinks.

Valor devuelto

rtlRealSuccessor devuelve un puntero al sucesor del nodo en Linkso NULL si el nodo no tiene sucesor.

Observaciones

El sucesor real de un nodo determinado se determina de la siguiente manera:

  • Si el nodo especificado tiene un subárbol derecho, el nodo situado más a la izquierda del subárbol derecho del nodo en Vínculos es el sucesor. Tenga en cuenta que rtlSubtreeSuccessor devuelve el mismo resultado para este caso.
  • De lo contrario, el nodo antecesor más cercano, del que el nodo especificado es un descendiente de subárbol izquierdo, es el sucesor.
Los autores de llamadas de las rutinas de vínculo de Rtl splay son responsables de sincronizar el acceso al árbol de vínculos de reproducción. Una exclusión mutua rápida es el mecanismo de sincronización más eficaz que se usará para este propósito.

Los autores de llamadas de RtlRealSuccessor deben ejecutarse en IRQL <= DISPATCH_LEVEL si el árbol no está paginado. Normalmente, los autores de llamadas se ejecutan en irQL PASSIVE_LEVEL.

Requisitos

Requisito Valor
cliente mínimo admitido Esta rutina está disponible en Microsoft Windows 2000 y versiones posteriores.
de la plataforma de destino de Universal
encabezado de ntddk.h (incluya Ntddk.h, Ntifs.h)
biblioteca de NtosKrnl.lib
DLL de NtosKrnl.exe
irQL Consulte la sección Comentarios.

Consulte también

RtlRealPredecessor

rtlSplay de

rtlSubtreeSuccessor