PopEntryList-Funktion (wdm.h)
Die PopEntryList-Routine entfernt den ersten Eintrag aus einer einfach verknüpften Liste mit SINGLE_LIST_ENTRY Strukturen.
Syntax
PSINGLE_LIST_ENTRY PopEntryList(
[in, out] PSINGLE_LIST_ENTRY ListHead
);
Parameter
[in, out] ListHead
Zeiger auf die SINGLE_LIST_ENTRY-Struktur , die den Kopf der Liste darstellt. Bei der Rückgabe zeigt ListHead-Next> auf den Anfang der Liste, wobei der erste Eintrag entfernt wurde.
Rückgabewert
PopEntryList gibt einen Zeiger auf den Eintrag zurück, der aus der Liste entfernt wurde, oder NULL , wenn die Liste derzeit leer ist.
Hinweise
PopEntryList entfernt den ersten Eintrag aus der Liste, indem ListHead-Next> festgelegt wird, um auf den zweiten Eintrag in der Liste zu zeigen.
Informationen zur Verwendung dieser Routine beim Implementieren einer singly verknüpften Liste finden Sie unter Singly und Doubly Linked Listen.
Aufrufer von PopEntryList können in jedem IRQL ausgeführt werden. Wenn PopEntryList unter IRQL >= DISPATCH_LEVEL aufgerufen wird, müssen der Speicher für ListHead und die Listeneinträge resident sein.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 2000. |
| Zielplattform | Desktop |
| Kopfzeile | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h) |
| IRQL | Beliebige Ebene (siehe Abschnitt Hinweise) |