IsListEmpty

The IsListEmpty routine indicates whether a doubly linked, driver-maintained list is empty.

BOOLEAN 
  IsListEmpty(
    IN PLIST_ENTRY  ListHead
    );

Parameters

ListHead

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

The ListHead of type LIST_ENTRY is doubly linked.

Return Value

IsListEmpty returns TRUE if there are currently no entries in the list.

Headers

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

Comments

Callers of IsListEmpty 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

InitializeListHead, RemoveHeadList, RemoveTailList, RemoveEntryList