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

See also

ExInterlockedPopEntryList

PushEntryList