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

Artigo
08/07/2023

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.

Retornar valor

Nenhum

Comentários

Esse é um retorno de chamada opcional. Registre essa função de retorno de chamada em seu retorno de chamada EVT_NET_ADAPTER_CREATE_TX(rxQueueContext)QUEUE . Defina o membro apropriado de uma estrutura NET_PACKET_QUEUE_CONFIG depois de inicializar a estrutura com NET_PACKET_QUEUE_CONFIG_INIT e, 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_CANCEL ou EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED após o retorno de EvtPacketQueueStop . Além disso, EvtPacketQueueStop é chamado no mesmo contexto de execução ou thread, como EvtPacketQueueAdvance, EvtPacketQueueCancel e EvtPacketQueueSetNotificationEnabled, para que os drivers de cliente não precisem 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.