The IsListEmpty routine indicates whether a doubly linked list of LIST_ENTRY structures is empty.

BOOLEAN 
  IsListEmpty(
    IN PLIST_ENTRY  ListHead
    );

Parameters

ListHead

Pointer to a LIST_ENTRY structure that represents the head of the list.

Return Value

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

Comments

IsListEmpty returns TRUE if ListHead->Flink refers back to ListHead.

For information about using this routine when implementing a doubly linked list, see Singly and Doubly Linked Lists.

Callers of IsListEmpty can be running at any IRQL. If IsListEmpty is called at IRQL >= DISPATCH_LEVEL the storage for ListHead must be resident.

Requirements

IRQL: Any level (see Comments section)

Headers: Declared in Wdm.h. Include Wdm.h, Ntddk.h, or Ntifs.h.

See Also

InitializeListHead, RemoveHeadList, RemoveTailList, RemoveEntryList