Export (0) Print
Expand All
Expand Minimize

ExInterlockedPopEntryList routine

The ExInterlockedPopEntryList routine atomically removes an entry from the beginning of a singly linked list of SINGLE_LIST_ENTRY structures.

Syntax


PSINGLE_LIST_ENTRY ExInterlockedPopEntryList(
  _Inout_  PSINGLE_LIST_ENTRY ListHead,
  _Inout_  PKSPIN_LOCK        Lock
);

Parameters

ListHead [in, out]

A pointer to the SINGLE_LIST_ENTRY structure that serves as the list header.

Lock [in, out]

A pointer to a KSPIN_LOCK structure that serves as the spin lock used to synchronize access to the list. The storage for the spin lock must be resident and must have been initialized by calling KeInitializeSpinLock. You must use this spin lock only with the ExInterlockedXxxList routines.

Return value

ExInterlockedPopEntryList returns a pointer to the SINGLE_LIST_ENTRY structure removed from the list. If the list was empty, the routine returns NULL.

Remarks

ExInterlockedPopEntryList performs the same operation as PopEntryList, but atomically. Do not mix atomic and non-atomic calls on the same list.

For more information about using this routine to implement a singly linked list, see Singly and Doubly Linked Lists.

The ExInterlockedPopEntryList routine can be called at any IRQL. The storage for the ListHead parameter must be resident at all IRQLs.

Requirements

Target platform

Universal

Version

Available starting with Windows 2000.

Header

Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)

Library

Ntoskrnl.lib

IRQL

Any level (see Remarks section)

See also

ExInitializeSListHead
ExInterlockedPopEntrySList
ExInterlockedPushEntryList
KeInitializeSpinLock
PopEntryList

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft