InitializeListHead function (wdm.h)

Article
02/22/2024

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)