Previous Next

InsertHeadList

The InsertHeadList routine inserts an entry at the head of a doubly linked, driver-managed list.

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.

Return Value

None

Headers

Declared in wdm.h and ntddk.h. Include wdm.h or ntddk.h.

Comments

Callers of InsertHeadList 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

ExInterlockedInsertHeadList, InitializeListHead, InsertTailList, IsListEmpty, RemoveHeadList, RemoveTailList