PopEntryList

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

At a Glance

Header file: Ntcompat.h
Windows CE versions: 2.0 and later

Syntax

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 Values

Returns a pointer to the last-pushed entry in last-in, first-out ( LIFO ) order or a NULL pointer if the list is currently empty.

Remarks

A driver that calls this function 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

PushEntryList