Fonction RtlIsGenericTableEmptyAvl (ntddk.h)
La routine RtlIsGenericTableEmptyAvl détermine si une table générique est vide.
Syntaxe
NTSYSAPI BOOLEAN RtlIsGenericTableEmptyAvl(
[in] PRTL_AVL_TABLE Table
);
Paramètres
[in] Table
Pointeur vers la table générique (RTL_GENERIC_TABLE). La table doit avoir été initialisée en appelant RtlIsGenericTableEmptyAvl.
Valeur retournée
RtlIsGenericTableEmptyAvl retourne FALSE si la table contient un ou plusieurs éléments, true dans le cas contraire.
Remarques
Par défaut, le système d’exploitation utilise des arborescences de lecture pour implémenter des tables génériques, mais la routine RtlIsGenericTableEmptyAvl 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 RtlIsGenericTableEmptyAvl au lieu de RtlIsGenericTableEmpty. Dans l’appel à RtlIsGenericTableEmptyAvl, l’appelant doit passer une structure de table RTL_AVL_TABLE plutôt qu’RTL_GENERIC_TABLE.
Les appelants de RtlIsGenericTableEmptyAvl doivent être en cours d’exécution à ≤ APC_LEVEL si la mémoire allouée à l’appelant sur Table est paginable.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows XP. |
| Plateforme cible | Universal |
| En-tête | ntddk.h (inclure Ntddk.h, Ntifs.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL (voir la section Notes) |