Função RtlInsertAsRightChild (ntddk.h)

Artigo
02/26/2024

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

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.

Retornar valor

Nenhum

Comentários

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 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 das rotinas de link de reprodução rtl 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 em IRQL <= DISPATCH_LEVEL se a árvore de link de reprodução e o nó ChildLinks não forempagados. Normalmente, os chamadores estão em execução no IRQL PASSIVE_LEVEL.