Macro NdisInterlockedInsertHeadList (ndis.h)

  • Artigo

A função NdisInterlockedInsertHeadList insere uma entrada, geralmente um pacote, no cabeçalho de uma lista duplamente vinculada para que o acesso à lista seja sincronizado de maneira segura para vários processadores.

Sintaxe

void NdisInterlockedInsertHeadList(
  [in]  _ListHead,
  [in]  _ListEntry,
  [in]  _SpinLock
);

Parâmetros

[in] _ListHead

Um ponteiro para o cabeçalho da lista duplamente vinculada na qual uma entrada deve ser inserida.

[in] _ListEntry

Um ponteiro para a entrada a ser inserida no cabeçalho da lista.

[in] _SpinLock

Um ponteiro para um bloqueio de rotação fornecido pelo chamador, usado para sincronizar o acesso à lista.

Retornar valor

Nenhum

Comentários

Antes de chamar NdisInterlockedInsertHeadList, um driver deve inicializar a variável em ListHead com a função NdisInitializeListHead e a variável em SpinLock com a função NdisAllocateSpinLock . O driver também deve fornecer armazenamento residente para essas variáveis e para sua fila interna.

O bloqueio de rotação fornecido pelo chamador impede que qualquer outra função acesse a fila interna do driver enquanto NdisInterlockedInsertHeadList está inserindo a entrada fornecida, mesmo quando o driver está em execução em um computador multiprocessador.

NdisInterlockedInsertHeadList eleva o IRQL para DISPATCH_LEVEL quando ele adquire o bloqueio de rotação especificado e restaura o IRQL original antes de retornar o controle. Consequentemente, qualquer função de driver que chame NdisInterlockedInsertHeadList não pode ser um código paginável.

A maioria dos drivers NDIS processa pacotes na ordem FIFO, portanto, qualquer driver que usa uma fila intertravada tende a calar o botão A função NdisInterlockedInsertTailList é muito mais frequente do que NdisInterlockedInsertHeadList. Esse driver geralmente chama NdisInterlockedInsertHeadList apenas para redirecionar um pacote para uma operação de repetição.

Para converter um valor retornado de volta para o endereço da entrada inserida, um driver pode usar a macro CONTAINING_RECORD .

Se NdisInterlockedInsertHeadList for chamado em IRQL >= DISPATCH_LEVEL, o armazenamento para o parâmetro ListHead e as entradas de lista deverão ser residentes.

Requisitos

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

Confira também

CONTAINING_RECORD

NdisAllocateSpinLock

NdisInitializeListHead

NdisInterlockedInsertTailList NdisInterlockedRemoveHeadList