EVT_PACKET_QUEUE_STOP função de retorno de chamada (netpacketqueue.h)

Artigo
02/07/2025

A função de retorno de chamada EvtPacketQueueStop é um retorno de chamada opcional implementado pelo driver cliente para interromper o caminho de dados de uma fila de pacotes.

Sintaxe

EVT_PACKET_QUEUE_STOP EvtPacketQueueStop;

void EvtPacketQueueStop(
  [_In_] NETPACKETQUEUE PacketQueue
)
{...}

Parâmetros

[_In_] PacketQueue

Um identificador para uma fila de pacotes.

Valor de retorno

Nenhum

Observações

Esse é um retorno de chamada opcional. Registre essa função de retorno de chamada em seu EVT_NET_ADAPTER_CREATE_TX(rxQueueContext)QUEUE retorno de chamada. Defina o membro apropriado de uma estrutura de NET_PACKET_QUEUE_CONFIG depois de inicializar a estrutura com NET_PACKET_QUEUE_CONFIG_INITe, em seguida, chame NetTx(rxQueueContext)QueueCreate.

Esse retorno de chamada não retorna um valor e, portanto, não deve falhar, portanto, esse retorno de chamada deve ser uma função leve que é executada rapidamente.

Os drivers cliente não receberão chamadas para EVT_PACKET_QUEUE_ADVANCE, EVT_PACKET_QUEUE_CANCELou EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED após retorna EvtPacketQueueStop. Além disso, EvtPacketQueueStop é chamado no mesmo contexto de execução, ou thread, como EvtPacketQueueAdvance, EvtPacketQueueCancele EvtPacketQueueSetNotificationEnabled, portanto, os drivers cliente não precisam sincronizar entre essas funções de retorno de chamada para uma instância de fila individual.

Para obter mais informações e um diagrama mostrando o modelo de sondagem do caminho de dados NetAdapterCx, consulte Transmitir e receber filas.

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
versão mínima do KMDF	1.27
versão mínima do UMDF	2.33
cabeçalho	netpacketqueue.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL