Partager via


Fonction RtlSplay (ntddk.h)

Le RtlSplay rééquilibrage de routine, ou « splays », une arborescence de liens de lecture autour du lien de lecture spécifié, ce qui rend ce lien la nouvelle racine de l’arborescence.

Syntaxe

NTSYSAPI PRTL_SPLAY_LINKS RtlSplay(
  [in, out] PRTL_SPLAY_LINKS Links
);

Paramètres

[in, out] Links

Pointeur vers le nœud qui doit devenir le nœud racine de l’arborescence de liens de lecture rééquilibrée. Le nœud doit avoir été initialisé en appelant RtlInitializeSplayLinks.

Valeur de retour

RtlSplay retourne le pointeur Liens lorsqu’il a rééquilibré l’arborescence.

Remarques

Si L est le lien donné, P est son nœud parent et G est son nœud grand-parent, RtlSplay rééquilibrer une arborescence de liens de lecture en fonction de l’un des six modèles indiqués dans la figure suivante.

Diagramme illustrant le rééquilibrage d’une arborescence de liens de lecture, où L est le lien donné, P est son nœud parent et G est son nœud grand-parent.

Les appelants du Rtl routines de liaison de lecture sont responsables de la synchronisation de l’accès à l’arborescence des liens de lecture. Un mutex rapide est le mécanisme de synchronisation le plus efficace à utiliser à cet effet.

Les appelants de RtlSplay doivent s’exécuter au <IRQL = DISPATCH_LEVEL si l’arborescence n’est pas paginé. En règle générale, les appelants s’exécutent au PASSIVE_LEVEL IRQL.

Exigences

Exigence Valeur
plateforme cible Universel
d’en-tête ntddk.h (include Ntddk.h, Ntifs.h)
bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Voir la section Remarques.

Voir aussi

RtlDelete

RtlInitializeSplayLinks

RtlInsertAsLeftChild

RtlInsertAsRightChild