NetTxQueueNotifyMoreCompletedPacketsAvailable, fonction (nettxqueue.h)
Le pilote client appelle NetTxQueueNotifyMoreCompletedPacketsAvailable pour reprendre les opérations de file d’attente après que NetAdapterCx appelle 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
Aucun
Remarques
Cette fonction ne doit être appelée que lorsque l’interrogation est désactivée.
Une fois que NetAdapterCx appelle 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_RINGde la file d’attente de transmission.
Le client ne doit appeler NetTxQueueNotifyMoreCompletedPacketsAvailable une fois par activation de la notification. Si l’appel le plus récent à EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED a NotificationEnabled défini sur FALSE, le client doit éviter d’appeler NetTxQueueNotifyMoreCompletedPacketsAvailable. Étant donné que NetAdapterCx appelle EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED à plusieurs reprises, le client peut manquer quelques cas et appeler NetTxQueueNotifyMoreCompletedPacketsAvailable lorsque NotificationEnabled est défini sur FALSE. Dans ces cas, l’appel sera un no-op.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.27 |
| version minimale de UMDF | 2.33 |
| d’en-tête | nettxqueue.h (include netadaptercx.h) |
| IRQL | <= HIGH_LEVEL |