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)

Weitere Informationen

ExInterlockedPopEntryList

PushEntryList