Função RtlInsertAsLeftChild (ntddk.h)

Artigo
02/29/2024

A rotina RtlInsertAsLeftChild insere um nó de link de reprodução na árvore como o filho esquerdo do nó especificado.

Sintaxe

void RtlInsertAsLeftChild(
  [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 esquerdo.

[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 RtlInsertAsLeftChild devem atender aos seguintes critérios:

O nó em ParentLinks não deve ter nenhum filho à esquerda.
Um chamador pode determinar se o nó já tem um filho esquerdo chamando RtlLeftChild. Se RtlLeftChild retornar NULL, ParentLinks será um parâmetro válido para RtlInsertAsLeftChild.
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 RtlInsertAsLeftChild. Se RtlParent retornar um ponteiro equivalente para ChildLinks, ChildLinks será um parâmetro válido para RtlInsertAsLeftChild.

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 RtlInsertAsLeftChild 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.