NetTxQueueNotifyMoreCompletedPacketsAvailable, fonction (nettxqueue.h)

  • Article

Le pilote client appelle NetTxQueueNotifyMoreCompletedPacketsAvailable pour reprendre les opérations de file d’attente après que NetAdapterCx a appelé la routine de rappel d’événement EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED du client.

Syntaxe

void NetTxQueueNotifyMoreCompletedPacketsAvailable(
  [_In_] NETPACKETQUEUE PacketQueue
);

Paramètres

[_In_] PacketQueue

Handle vers une file d’attente de transmission nette.

Valeur de retour

None

Remarques

Cette fonction ne doit être appelée que lorsque l’interrogation est désactivée.

Après que NetAdapterCx a appelé la routine de rappel d’événement EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED d’un pilote client avec NotificationEnabled défini sur TRUE, le client active l’interruption matérielle de la file d’attente. Lorsque l’appareil génère une interruption matérielle, le client appelle généralement NetTxQueueNotifyMoreCompletedPacketsAvailable à partir de sa fonction de rappel *EVT_WDF_INTERRUPT_DPC , une fois qu’il a terminé une NET_PACKET en attente dans le NET_RING de la file d’attente de transmission.

Le client ne doit appeler NetTxQueueNotifyMoreCompletedPacketsAvailable qu’une fois par activation de la notification. Si l’appel le plus récent à EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED a la valeur FALSE pour NotificationEnabled, le client doit éviter d’appeler NetTxQueueNotifyMoreCompletedPacketsAvailable. Étant donné que NetAdapterCx appelle EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED plusieurs fois, le client peut manquer quelques cas et appeler NetTxQueueNotifyMoreCompletedPacketsAvailable lorsque NotificationEnabled a la valeur FALSE. Dans ce cas, l’appel sera une opération sans opération.

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1,27 %
En-tête nettxqueue.h (inclure netadaptercx.h)
IRQL <= HIGH_LEVEL

Voir aussi

EVT_PACKET_QUEUE_ADVANCE

EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED