The PushEntryList routine inserts an entry at the beginning of a singly linked list of SINGLE_LIST_ENTRY structures.

VOID 
  PushEntryList(
    IN PSINGLE_LIST_ENTRY  ListHead,
    IN PSINGLE_LIST_ENTRY  Entry
    );

Parameters

ListHead

Pointer to the SINGLE_LIST_ENTRY structure that serves as the list header.

Entry

Pointer to SINGLE_LIST_ENTRY structure that represents the entry to be inserted on the list.

Return Value

None

Comments

PushEntryList sets ListHead->Next to Entry, and Entry->Next to point to the old first entry of the list.

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

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

Requirements

IRQL: Any level (See Comments section)

Headers: Declared in Wdm.h. Include Wdm.h, Ntddk.h, or Ntifs.h.

See Also

ExInterlockedPushEntryList, PopEntryList