Macro NdisInitializeListHead (ndis.h)

A função NdisInitializeListHead inicializa uma fila duplamente vinculada e mantida pelo driver.

Sintaxe

void NdisInitializeListHead(
  [in]  _ListHead
);

Parâmetros

[in] _ListHead

Um ponteiro para o armazenamento nãopagado alocado por driver para o cabeçalho da fila ou lista interligada.

Retornar valor

Nenhum

Comentários

NdisInitializeListHead pode ser chamado de uma função MiniportInitializeEx ou da rotina DriverEntry de um driver de protocolo se o driver enfileirar solicitações internamente. No entanto, os drivers de miniporto raramente configuram filas internas porque a biblioteca NDIS serializa solicitações e pacotes enviados para drivers de miniporta.

Qualquer driver NDIS que mantém uma fila interna é responsável por sincronizar os acessos das funções de driver a entradas enfileiradas. As funções NdisInterlockedXxxList garantem que apenas uma função de driver possa acessar entradas enfileiradas a qualquer momento, mesmo que o driver esteja em execução em um computador multiprocessador, pois a fila é protegida por um bloqueio de rotação fornecido pelo chamador.

Para uma fila interligada, o driver também deve fornecer armazenamento nãopagado para um bloqueio de rotação. Ele deve inicializar o bloqueio de rotação com a função NdisAllocateSpinLock antes de passar um ponteiro para esse bloqueio de rotação para qualquer uma das funções NdisInterlockedXxxList .

Os chamadores de NdisInitializeListHead podem estar em execução em qualquer IRQL. Se NdisInitializeListHead for chamado em IRQL >= DISPATCH_LEVEL o armazenamento para ListHead deverá ser residente.

Requisitos

Confira também

DriverEntry de drivers de protocolo NDIS

MiniportInitializeEx

NdisAllocateSpinLock