EVT_PACKET_QUEUE_STOP fonction de rappel (netpacketqueue.h)
La fonction de rappel EvtPacketQueueStop est un rappel facultatif implémenté par le pilote client pour arrêter le chemin des données d’une file d’attente de paquets.
Syntaxe
EVT_PACKET_QUEUE_STOP EvtPacketQueueStop;
void EvtPacketQueueStop(
[_In_] NETPACKETQUEUE PacketQueue
)
{...}
Paramètres
[_In_] PacketQueue
Handle dans une file d’attente de paquets.
Valeur de retour
None
Remarques
Il s’agit d’un rappel facultatif. Inscrivez cette fonction de rappel dans votre rappel EVT_NET_ADAPTER_CREATE_TX(rxQueueContext)QUEUE . Définissez le membre approprié d’une structure NET_PACKET_QUEUE_CONFIG après avoir initialisé la structure avec NET_PACKET_QUEUE_CONFIG_INIT, puis appelez NetTx(rxQueueContext)QueueCreate.
Ce rappel ne retourne pas de valeur et ne doit donc pas échouer. Ce rappel doit donc être une fonction légère qui s’exécute rapidement.
Les pilotes clients ne recevront pas d’appels à EVT_PACKET_QUEUE_ADVANCE, EVT_PACKET_QUEUE_CANCEL ou EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED après le retour d’EvtPacketQueueStop . En outre, EvtPacketQueueStop est appelé dans le même contexte d’exécution, ou thread, que EvtPacketQueueAdvance, EvtPacketQueueCancel et EvtPacketQueueSetNotificationEnabled, de sorte que les pilotes clients n’ont pas besoin de se synchroniser entre ces fonctions de rappel pour une file d’attente individuelle instance.
Pour plus d’informations et un diagramme montrant le modèle d’interrogation du chemin de données NetAdapterCx, consultez Files d’attente de transmission et de réception.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1,27 % |
| Version UMDF minimale | 2,33 |
| En-tête | netpacketqueue.h (inclure netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |
Voir aussi
EVT_NET_ADAPTER_CREATE_RXQUEUE
EVT_NET_ADAPTER_CREATE_TXQUEUE