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 sucesor del subárbol del nodo en Linkso NULL si el nodo especificado no tiene ningún sucesor de subárbol.
Observaciones
Si el nodo de Vínculos 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 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 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 | 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. |