NetRxQueueNotifyMoreReceivedPacketsAvailable, fonction (netrxqueue.h)
Le pilote client appelle NetRxQueueNotifyMoreReceivedPacketsAvailable 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 NetRxQueueNotifyMoreReceivedPacketsAvailable(
[_In_] NETPACKETQUEUE PacketQueue
);
Paramètres
[_In_] PacketQueue
Handle pour un objet de file d’attente de réception 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 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_RING de la file d’attente de réception.
Le client ne doit appeler NetRxQueueNotifyMoreReceivedPacketsAvailable qu’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 fois, le client peut manquer quelques cas et appeler NetRxQueueNotifyMoreReceivedPacketsAvailable 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 | netrxqueue.h (inclure netadaptercx.h) |
| IRQL | <= HIGH_LEVEL |