Compartilhar via


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

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 no 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 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 de 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.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.27
Versão mínima do UMDF 2.33
Cabeçalho netpacketqueue.h (inclua netadaptercx.h)
IRQL PASSIVE_LEVEL

Confira também

EVT_NET_ADAPTER_CREATE_RXQUEUE

EVT_NET_ADAPTER_CREATE_TXQUEUE

NetRxQueueCreate

NetTxQueueCreate

EVT_PACKET_QUEUE_START

EVT_PACKET_QUEUE_ADVANCE

EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED

EVT_PACKET_QUEUE_CANCEL