PopEntryList, fonction (wdm.h)
La routine PopEntryList supprime la première entrée d’une liste de structures SINGLE_LIST_ENTRY liées séparément.
Syntaxe
PSINGLE_LIST_ENTRY PopEntryList(
[in, out] PSINGLE_LIST_ENTRY ListHead
);
Paramètres
[in, out] ListHead
Pointeur vers la structure SINGLE_LIST_ENTRY qui représente le début de la liste. Au retour, ListHead-Next> pointe vers le début de la liste avec la première entrée supprimée.
Valeur retournée
PopEntryList retourne un pointeur vers l’entrée supprimée de la liste, ou NULL si la liste est actuellement vide.
Remarques
PopEntryList supprime la première entrée de la liste en définissant ListHead-Next> sur la deuxième entrée de la liste.
Pour plus d’informations sur l’utilisation de cette routine lors de l’implémentation d’une liste liée séparément, consultez Singly and Doubly Linked Listes.
Les appelants de PopEntryList peuvent être en cours d’exécution sur n’importe quel IRQL. Si PopEntryList est appelé dans IRQL >= DISPATCH_LEVEL, le stockage pour ListHead et les entrées de liste doivent être résidents.
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) |