Expand Minimize

IsListEmpty routine

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

Syntax


BOOLEAN IsListEmpty(
  _In_ const LIST_ENTRY *ListHead
);

Parameters

ListHead [in]

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.

Remarks

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

Target platform

Desktop

Version

Available starting with Windows 2000.

Header

Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)

IRQL

Any level (see Remarks section)

See also

InitializeListHead
RemoveHeadList
RemoveTailList
RemoveEntryList

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft