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 Links o NULL si el nodo no tiene sucesor.

Comentarios

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 en el subárbol derecho del nodo en Links 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 reproducción rtl 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 Value
Cliente mínimo compatible Esta rutina está disponible en Microsoft Windows 2000 y versiones posteriores.
Plataforma de destino Universal
Encabezado ntddk.h (incluya Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL vea la sección Comentarios.

Consulte también

RtlRealPredecessor

RtlSplay

RtlSubtreeSuccessor