Macro NdisInterlockedPopEntrySList (ndis.h)

Artigo
02/29/2024

A função NdisInterlockedPopEntrySList remove a primeira entrada de uma lista sequenciada e vinculada.

Sintaxe

void NdisInterlockedPopEntrySList(
        SListHead,
  [in]  Lock
);

Parâmetros

SListHead

Um ponteiro para o cabeçalho da lista já inicializada sequenciada e vinculada da qual a entrada deve ser retornada.

[in] Lock

Um ponteiro para um bloqueio de rotação fornecido pelo chamador, não mantido atualmente pelo chamador.

Retornar valor

Nenhum

Comentários

Um driver não deve estar segurando o Bloqueio especificado quando chama NdisInterlockedPopEntrySList. Se necessário, o driver deve chamar a função NdisReleaseSpinLock antes de fazer essa chamada. O próprio NdisInterlockedPopEntrySList deve adquirir esse bloqueio de rotação para remover a primeira entrada na Lista S, se houver, de maneira segura para vários processadores.

O chamador deve fornecer armazenamento residente para o Lock, que deve ser inicializado com a função NdisAllocateSpinLock antes da chamada inicial para qualquer NdisInterlocked.. Função SList .

Se NdisInterlockedPopEntrySList for chamado em IRQL >= DISPATCH_LEVEL, o armazenamento do parâmetro ListHead deverá ser residente.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisInterlockedPopEntrySList (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisInterlockedPopEntrySList (NDIS 5.1)) no Windows XP.
Plataforma de Destino	Área de Trabalho
Cabeçalho	ndis.h (inclua Ndis.h)
IRQL	Qualquer nível