PushEntryList function (wdm.h)

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

Syntax

void PushEntryList(
  [in, out] PSINGLE_LIST_ENTRY                  ListHead,
  [in, out] __drv_aliasesMem PSINGLE_LIST_ENTRY Entry
);

Parameters

[in, out] ListHead

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

[in, out] Entry

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

Return value

None

Remarks

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

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

ExInterlockedPushEntryList

PopEntryList