InsertHeadList

This function inserts an entry at the head of a doubly-linked, driver-managed list.

At a Glance

Syntax

VOID InsertHeadList( IN PLIST_ENTRY ListHead,
IN PLIST_ENTRY Entry );

Parameters

ListHead

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

The ListHead of type LIST_ENTRY is doubly linked.

Entry

Pointer to an entry to be inserted in the list.

Remarks

A driver that calls this function 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, InsertTailList, IsListEmpty, RemoveHeadList, RemoveTailList