NetRxQueueNotifyMoreReceivedPacketsAvailable, fonction (netrxqueue.h)
Le pilote client appelle NetRxQueueNotifyMoreReceivedPacketsAvailable 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 NetRxQueueNotifyMoreReceivedPacketsAvailable(
[_In_] NETPACKETQUEUE PacketQueue
);
Paramètres
[_In_] PacketQueue
Handle vers un objet de file d’attente de réception net.
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 NetRxQueueNotifyMoreReceivedPacketsAvailable à 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 réception.
Le client doit uniquement appeler NetRxQueueNotifyMoreReceivedPacketsAvailable 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 NetRxQueueNotifyMoreReceivedPacketsAvailable. Étant donné que NetAdapterCx appelle EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED à plusieurs reprises, le client peut manquer quelques cas et appeler NetRxQueueNotifyMoreReceivedPacketsAvailable 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 | netrxqueue.h (include netadaptercx.h) |
| IRQL | <= HIGH_LEVEL |