InterlockedPushListSListEx function
Inserts a singly-linked list at the front of another singly linked list. Access to the lists is synchronized on a multiprocessor system. This version of the method does not use the __fastcall calling convention.
Syntax
PSLIST_ENTRY WINAPI InterlockedPushListSListEx( _Inout_ PSLIST_HEADER ListHead, _Inout_ PSLIST_ENTRY List, _Inout_ PSLIST_ENTRY ListEnd, _In_ ULONG Count );
Parameters
- ListHead [in, out]
-
Pointer to an SLIST_HEADER structure that represents the head of a singly linked list. The list specified by the List and ListEnd parameters is inserted at the front of this list.
- List [in, out]
-
Pointer to an SLIST_ENTRY structure that represents the first item in the list to be inserted.
- ListEnd [in, out]
-
Pointer to an SLIST_ENTRY structure that represents the last item in the list to be inserted.
- Count [in]
-
The number of items in the list to be inserted.
Return value
The return value is the previous first item in the list specified by the ListHead parameter. If the list was previously empty, the return value is NULL.
Remarks
All list items must be aligned on a MEMORY_ALLOCATION_ALIGNMENT boundary; otherwise, this function will behave unpredictably. See _aligned_malloc.
Requirements
|
Minimum supported client |
Windows 8 [desktop apps | Windows Store apps] |
|---|---|
|
Minimum supported server |
Windows Server 2012 [desktop apps | Windows Store apps] |
|
Minimum supported phone |
Windows Phone 8.1 |
|
Header |
|
|
Library |
|
|
DLL |
|
See also
- Interlocked Singly Linked Lists
- InterlockedPopEntrySList
- InterlockedPushEntrySList
- InterlockedFlushSList
- SLIST_ENTRY
- Using Singly Linked Lists