Fonction IsListEmpty (wdm.h)

La routine IsListEmpty indique si une liste doublement liée de structures LIST_ENTRY est vide.

Syntaxe

BOOLEAN IsListEmpty(
  [in] const LIST_ENTRY *ListHead
);

Paramètres

[in] ListHead

Pointeur vers une structure LIST_ENTRY qui représente le premier de la liste.

Valeur retournée

IsListEmpty retourne TRUE s’il n’y a actuellement aucune entrée dans la liste et FALSE dans le cas contraire.

Remarques

IsListEmpty retourne TRUE si ListHead-Flink> fait référence à ListHead.

Pour plus d’informations sur l’utilisation de cette routine lors de l’implémentation d’une liste doublement liée, consultez Singly and Doubly Linked Listes.

Les appelants d’IsListEmpty peuvent s’exécuter à n’importe quel IRQL. Si IsListEmpty est appelé à IRQL >= DISPATCH_LEVEL, le stockage pour ListHead doit être résident.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows 2000.
Plateforme cible Desktop (Expérience utilisateur)
En-tête wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)
IRQL N’importe quel niveau (voir la section Remarques)

Voir aussi

InitializeListHead

RemoveEntryList

RemoveHeadList

RemoveTailList