Expand Minimize

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.

Windows Phone 8.1: This API is supported.

Requirements

Minimum supported client

Windows 8 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 [desktop apps | Windows Store apps]

Header

Interlockedapi.h (include Windows.h)

Library

Kernel32.lib

DLL

Kernel32.dll

See also

Interlocked Singly Linked Lists
InterlockedPopEntrySList
InterlockedPushEntrySList
InterlockedFlushSList
SLIST_ENTRY
Using Singly Linked Lists

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.