Función RtlSubtreeSuccessor (ntddk.h)
La rutina RtlSubtreeSuccessor devuelve un puntero al sucesor del nodo especificado dentro del subárbol que se basa en ese nodo.
Sintaxis
NTSYSAPI PRTL_SPLAY_LINKS RtlSubtreeSuccessor(
[in] PRTL_SPLAY_LINKS Links
);
Parámetros
[in] Links
Puntero al nodo. El nodo debe haberse inicializado llamando a RtlInitializeSplayLinks.
Valor devuelto
RtlSubtreeSuccessor devuelve un puntero al subárbol sucesor del nodo en Links o NULL si el nodo especificado no tiene ningún sucesor de subárbol.
Comentarios
Si el nodo de Links tiene un subárbol derecho, el nodo situado más a la izquierda de ese subárbol es el sucesor del subárbol.
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 RtlSubtreeSuccessor deben ejecutarse en IRQL <= DISPATCH_LEVEL si el árbol no está paginado. Si el árbol está paginado, los autores de llamadas deben ejecutarse en IRQL < DISPATCH_LEVEL. 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. |