Função InterlockedPushEntrySList (interlockedapi.h)

Artigo
02/07/2024

Insere um item na frente de uma lista vinculada. O acesso à lista é sincronizado em um sistema multiprocessador.

Sintaxe

PSLIST_ENTRY InterlockedPushEntrySList(
  [in, out] PSLIST_HEADER                 ListHead,
  [in, out] __drv_aliasesMem PSLIST_ENTRY ListEntry
);

Parâmetros

[in, out] ListHead

Ponteiro para uma estrutura SLIST_HEADER que representa o cabeçalho de uma lista vinculada.

[in, out] ListEntry

Ponteiro para uma estrutura SLIST_ENTRY que representa um item em uma lista vinculada.

Retornar valor

O valor retornado é o primeiro item anterior na lista. Se a lista estava vazia anteriormente, o valor retornado é NULL.

Comentários

Todos os itens de lista devem ser alinhados em um limite de MEMORY_ALLOCATION_ALIGNMENT ; caso contrário, essa função se comportará de forma imprevisível. Confira _aligned_malloc.

Exemplos

Para obter um exemplo, consulte Using Singly Linked Listas.

Requisitos


Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho \| aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	interlockedapi.h (inclua Windows.h no Windows 7, Windows Server 2008 Windows Server 2008 R2)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll