EVT_PACKET_QUEUE_STOP fonction de rappel (netpacketqueue.h)

Article
02/26/2024

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