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 de 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 vers une file d’attente de paquets.
Valeur de retour
Aucun
Remarques
Il s’agit d’un rappel facultatif. Inscrivez cette fonction de rappel dans votre EVT_NET_ADAPTER_CREATE_TX(rxQueueContext)QUEUE rappel. 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_CANCELou EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED après EvtPacketQueueStop retourne. En outre, EvtPacketQueueStop est appelé dans le même contexte d’exécution, ou thread, comme EvtPacketQueueAdvance, EvtPacketQueueCancel, et EvtPacketQueueSetNotificationEnabled, de sorte que les pilotes clients n’ont pas besoin de synchroniser entre ces fonctions de rappel pour une instance de file d’attente individuelle.
Pour plus d’informations et un diagramme montrant le modèle d’interrogation du chemin de données NetAdapterCx, consultez Transmettre et recevoir des files d’attente.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.27 |
| version minimale de UMDF | 2.33 |
| d’en-tête | netpacketqueue.h (include netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |
Voir aussi
EVT_NET_ADAPTER_CREATE_RXQUEUE
EVT_NET_ADAPTER_CREATE_TXQUEUE