NetRxQueueNotifyMoreReceivedPacketsAvailable, fonction (netrxqueue.h)

  • Article

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énements 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

None

Remarques

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

Une fois 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 seule 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 a la valeur FALSE. Dans ce cas, l’appel sera une opération non opérationnelle.

Configuration requise

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

Voir aussi

EVT_PACKET_QUEUE_ADVANCE

EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED