Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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) |