Expand Minimize

ExInterlockedFlushSList routine

The ExInterlockedFlushSList routine atomically removes all entries from a sequenced singly linked list.

Syntax


PSLIST_ENTRY ExInterlockedFlushSList(
  _Inout_  PSLIST_HEADER ListHead
);

Parameters

ListHead [in, out]

A pointer to the SLIST_HEADER structure that serves as the header for the sequenced singly linked list.

Return value

If there were entries on the specified list, ExInterlockedFlushSList returns a pointer to the first SLIST_ENTRY structure that was entry on the list; otherwise, it returns NULL.

Remarks

ExInterlockedFlushSList does not delete the SLIST_ENTRY structures that made up the list; it only sets the internal pointer of ListHead to the beginning of the list to NULL. The driver must free the entries explicitly.

The routine returns a pointer to the first SLIST_ENTRY structure that was on the list. The driver can use this pointer to iterate through the entries.

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

Callers of ExInterlockedFlushSList can be running at any IRQL. The storage for the ListHead parameter and the list entries must be resident at all IRQLs.

Requirements

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

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft