PopEntryList

PSINGLE_LIST_ENTRY
    PopEntryList(
        IN PSINGLE_LIST_ENTRY  ListHead
        );

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

Parameters

ListHead

Points 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.

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