PopEntryList

The PopEntryList routine removes an entry in a singly linked, driver-managed list.

PSINGLE_LIST_ENTRY 
  PopEntryList(
    IN PSINGLE_LIST_ENTRY  ListHead
    );

Parameters

ListHead

Pointer to the driver-allocated storage for the head of the list.

The ListHead of type LIST_ENTRY is singly linked. The ListHead must be initialized to NULL before entries can be pushed and popped.

Return Value

PopEntryList returns a pointer to the last-pushed entry (LIFO order) or a NULL pointer if the list is currently empty.

Headers

Declared in wdm.h and ntddk.h. Include wdm.h or ntddk.h.

Comments

Callers of PopEntryList can be running at IRQL >= DISPATCH_LEVEL only if the caller-allocated storage for ListHead is resident, and only if pointers to every list entry remain valid at IRQL >= DISPATCH_LEVEL as well.

See Also

ExInterlockedPopEntryList, PushEntryList