PopEntryList function (wdm.h)
The PopEntryList routine removes the first entry from a singly linked list of SINGLE_LIST_ENTRY structures.
Syntax
PSINGLE_LIST_ENTRY PopEntryList(
[in, out] PSINGLE_LIST_ENTRY ListHead
);
Parameters
[in, out] ListHead
Pointer to the SINGLE_LIST_ENTRY structure that represents the head of the list. On return, ListHead->Next points to the beginning of the list with the first entry removed.
Return value
PopEntryList returns a pointer to the entry removed from the list, or NULL if the list is currently empty.
Remarks
PopEntryList removes the first entry from the list by setting ListHead->Next to point to the second entry in the list.
For information about using this routine when implementing a singly linked list, see Singly and Doubly Linked Lists.
Callers of PopEntryList can be running at any IRQL. If PopEntryList is called at IRQL >= DISPATCH_LEVEL, the storage for ListHead and the list entries must be resident.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available starting with Windows 2000. |
| Target Platform | Desktop |
| Header | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h) |
| IRQL | Any level (see Remarks section) |