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