Fonction RtlEnumerateGenericTableWithoutSplayingAvl (ntddk.h)

La routine RtlEnumerateGenericTableWithoutSplayingAvl est utilisée pour énumérer les éléments d’une table générique.

Syntaxe

NTSYSAPI PVOID RtlEnumerateGenericTableWithoutSplayingAvl(
  [in]      PRTL_AVL_TABLE Table,
  [in, out] PVOID          *RestartKey
);

Paramètres

[in] Table

Pointeur vers la table générique (RTL_AVL_TABLE). La table doit avoir été initialisée en appelant RtlInitializeGenericTableAvl.

[in, out] RestartKey

Adresse de l’élément retourné par l’appel précédent à RtlEnumerateGenericTableWithoutSplayingAvl. Doit être défini sur NULL si l’énumération doit commencer au premier élément de la table.

Pour énumérer tous les éléments de la table, utilisez RtlEnumerateGenericTableWithoutSplayingAvl comme suit :

RestartKey = NULL;
for (ptr = RtlEnumerateGenericTableWithoutSplayingAvl(Table, &RestartKey);
     ptr != NULL;
     ptr = RtlEnumerateGenericTableWithoutSplayingAvl(Table, &RestartKey)) {
        // Process the element pointed to by ptr
}

Valeur retournée

RtlEnumerateGenericTableWithoutSplayingAvl retourne un pointeur vers la structure définie par l’appelant associée à l’élément . Elle retourne NULL si RestartKey a la valeur NULL et que la table ne contient aucun élément ou si RestartKey est un pointeur retourné et qu’il n’y a pas d’élément suivant.

Remarques

La routine RtlEnumerateGenericTableWithoutSplayingAvl ne fonctionne pas réellement avec une arborescence de lecture, mais fournit une routine nommée analogue à RtlEnumerateGenericTableWithoutSplayingAvl.

RtlEnumerateGenericTableWithoutSplayingAvl peut être appelé à plusieurs reprises pour traiter les données de l’appelant dans chaque élément d’une table générique.

Par défaut, le système d’exploitation utilise des arborescences de lecture pour implémenter des tables génériques, mais la routine RtlLookupElementGenericTableFullAvl fonctionne uniquement avec les arborescences Adelson-Velsky/Landis (AVL). Pour configurer les routines de table génériques pour utiliser des arborescences AVL au lieu d’arborescences de lecture dans votre pilote, insérez l’instruction define suivante dans un fichier d’en-tête commun avant d’inclure Ntddk.h :

#define RTL_USE_AVL_TABLES 0

Si RTL_USE_AVL_TABLES n’est pas défini, vous devez utiliser la forme AVL des routines de table génériques. Par exemple, utilisez la routine RtlEnumerateGenericTableWithoutSplayingAvl au lieu de RtlEnumerateGenericTableWithoutSplaying. Dans l’appel à RtlEnumerateGenericTableWithoutSplayingAvl, l’appelant doit passer une structure de table RTL_AVL_TABLE plutôt qu’RTL_GENERIC_TABLE.

Les appelants du * Rtl.. Les routines GenericTableAvl* sont responsables de la synchronisation exclusive de l’accès à la table générique. Un mutex rapide exclusif est le mécanisme de synchronisation le plus efficace à utiliser à cet effet.

Les appelants de RtlEnumerateGenericTableWithoutSplayingAvl doivent s’exécuter sur IRQL < DISPATCH_LEVEL si la mémoire allouée à l’appelant pour la table générique est paginable.

Configuration requise

Voir aussi

RtlEnumerateGenericTableAvl

RtlInitializeGenericTableAvl

RtlIsGenericTableEmptyAvl

RtlNumberGenericTableElementsAvl