Função RtlInsertAsRightChild (ntddk.h)

Artigo
02/07/2025

A rotina RtlInsertAsRightChild insere um determinado link de reprodução na árvore como o filho direito de um determinado nó nessa árvore.

Sintaxe

void RtlInsertAsRightChild(
  [in] PRTL_SPLAY_LINKS ParentLinks,
  [in] PRTL_SPLAY_LINKS ChildLinks
);

Parâmetros

[in] ParentLinks

O ponteiro para o nó na árvore na qual ChildLinks deve ser inserido como o filho certo.

[in] ChildLinks

Ponteiro para o nó de link de reprodução a ser inserido na árvore. O nó deve ter sido inicializado chamando RtlInitializeSplayLinks.

Valor de retorno

Nenhum

Observações

Os chamadores de RtlInsertAsRightChild são responsáveis por atender aos seguintes critérios:

O nó em ParentLinks não deve ter um filho certo.
Um chamador pode determinar se o nó já tem um filho certo chamando rtlRightChild. Se RtlRightChild retornar NULL, ParentLinks será um parâmetro válido para rtlInsertAsRightChild.
O nó em ChildLinks não deve ter nenhum pai.
Um chamador pode determinar se esse nó já tem um pai chamando RtlIsRoot ou RtlParent. Se RtlIsRoot retornar TRUE quando chamado com ChildLinks, ChildLinks será um parâmetro válido para RtlInsertAsRightChild. Se RtlParent retornar um ponteiro equivalente para ChildLinks, ChildLinks também será um parâmetro válido para rtlInsertAsRightChild.

Os chamadores do Rtl rotinas de link de reprodução são responsáveis por sincronizar o acesso à árvore de link de reprodução. Um mutex rápido é o mecanismo de sincronização mais eficiente a ser usado para essa finalidade.

Os chamadores de RtlInsertAsRightChild devem estar em execução no IRQL <= DISPATCH_LEVEL se a árvore de link de reprodução e ChildLinks nó não forempagizados. Normalmente, os chamadores estão em execução no PASSIVE_LEVEL IRQL.