NetTxQueueNotifyMoreCompletedPacketsAvailable, fonction (nettxqueue.h)
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 % |
| Version UMDF minimale | 2,33 |
| En-tête | nettxqueue.h (inclure netadaptercx.h) |
| IRQL | <= HIGH_LEVEL |