Función RtlInsertAsLeftChild (ntddk.h)
El RtlInsertAsLeftChild rutina inserta un nodo de vínculo de reproducción en el árbol como elemento secundario izquierdo del nodo especificado.
void RtlInsertAsLeftChild(
[in] PRTL_SPLAY_LINKS ParentLinks,
[in] PRTL_SPLAY_LINKS ChildLinks
);
[in] ParentLinks
Puntero al nodo del árbol en el que se deben insertar childLinks como elemento secundario izquierdo.
[in] ChildLinks
Puntero al nodo de vínculo de reproducción que se va a insertar en el árbol. El nodo debe haberse inicializado llamando a RtlInitializeSplayLinks.
Ninguno
Los autores de llamadas de rtlInsertAsLeftChild deben cumplir los criterios siguientes:
-
El nodo de parentLinks no debe tener ningún elemento secundario izquierdo.
Un autor de llamada puede determinar si el nodo ya tiene un elemento secundario izquierdo llamando a RtlLeftChild. Si RtlLeftChild devuelve null, ParentLinks es un parámetro válido para RtlInsertAsLeftChild.
-
El nodo de ChildLinks no debe tener ningún elemento primario.
Un autor de llamada puede determinar si este nodo ya tiene un elemento primario llamando a RtlIsRoot o RtlParent. Si RtlIsRoot devuelve TRUE cuando se llama a con ChildLinks, ChildLinks es un parámetro válido para RtlInsertAsLeftChild. Si RtlParent devuelve un puntero equivalente a ChildLinks, ChildLinks es un parámetro válido para RtlInsertAsLeftChild.
Los autores de llamadas de RtlInsertAsLeftChild deben ejecutarse en IRQL <= DISPATCH_LEVEL si el árbol de vínculos de reproducción y nodo childLinks no están paginados. Normalmente, los autores de llamadas se ejecutan en irQL PASSIVE_LEVEL.
Requisito | Valor |
---|---|
de la plataforma de destino de | Escritorio |
encabezado de | ntddk.h (incluya Ntddk.h, Ntifs.h) |
irQL | Consulte la sección Comentarios. |