InterlockedPushListSList, fonction

Article
02/12/2024

Description

Insère une liste liée unique au début d’une autre liste liée unique.

L’accès aux listes est synchronisé sur un système multiprocesseur.

PSLIST_ENTRY  FASTCALL InterlockedPushListSList(
  _Inout_ PSLIST_HEADER ListHead,
  _Inout_ PSLIST_ENTRY  List,
  _Inout_ PSLIST_ENTRY  ListEnd,
  _In_    ULONG         Count
);

Paramètres

ListHead [in, out]

Pointeur vers une structure SLIST_HEADER qui représente la tête d’une liste liée unique. La liste spécifiée par les paramètres List et ListEnd est insérée à l’avant de cette liste.

Liste [in, out]

Pointeur vers une structure SLIST_ENTRY qui représente le premier élément de la liste à insérer.

ListEnd [in, out]

Pointeur vers une structure SLIST_ENTRY qui représente le dernier élément de la liste à insérer.

Count[in]

Nombre d'éléments dans la liste à insérer.

Retours

La valeur de retour est le premier élément précédent de la liste spécifiée par le paramètre ListHead. Si la liste était précédemment vide, la valeur de retour est NULLE.

Notes

Tous les éléments de liste doivent être alignés sur une limite MEMORY_ALLOCATION_ALIGNMENT, sinon, cette fonction se comporte de manière imprévisible. Consultez _aligned_malloc.

Windows 8 et Windows Server 2012 : cette fonction a été remplacée par InterlockedPushListSListEx.

Lors de la compilation avec NTDDI_VERSION définie sur NTDDI_WIN8 ou une version ultérieure, les appels à InterlockedPushListSList vont à la place à InterlockedPushListSListEx.