InitializeListHead function (wdm.h)

The InitializeListHead routine initializes a LIST_ENTRY structure that represents the head of a doubly linked list.

Syntax

void InitializeListHead(
  [out] PLIST_ENTRY ListHead
);

Parameters

[out] ListHead

Pointer to a LIST_ENTRY structure that serves as the list header.

Return value

None

Remarks

The InitializeListHead routine sets the Flink and Blink members of ListHead to point to ListHead.

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

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

Requirements

Requirement Value
Minimum supported client Available starting with Windows 2000.
Target Platform Desktop
Header wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Wudfwdm.h)
IRQL Any level (see Remarks section)

See also

ExInterlockedInsertHeadList

ExInterlockedInsertTailList

ExInterlockedPopEntryList

ExInterlockedPushEntryList

ExInterlockedRemoveHeadList

InsertHeadList

InsertTailList

IsListEmpty

KeInitializeSpinLock

PopEntryList

PushEntryList

RemoveEntryList

RemoveHeadList

RemoveTailList