NetRxQueueNotifyMoreReceivedPacketsAvailable-Funktion (netrxqueue.h)
Der Clienttreiber ruft NetRxQueueNotifyMoreReceivedPacketsAvailable auf, um Warteschlangenvorgänge fortzusetzen, nachdem NetAdapterCx die EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED Ereignisrückrufroutine des Clients aufgerufen hat.
Syntax
void NetRxQueueNotifyMoreReceivedPacketsAvailable(
[_In_] NETPACKETQUEUE PacketQueue
);
Parameter
[_In_] PacketQueue
Ein Handle für ein Net Receive Queue-Objekt.
Rückgabewert
Keine
Bemerkungen
Diese Funktion sollte nur aufgerufen werden, wenn die Abruffunktion deaktiviert ist.
Nachdem NetAdapterCx die EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED Ereignisrückrufroutine eines Clienttreibers aufgerufen hat, wobei NotificationEnabled auf TRUE festgelegt ist, aktiviert der Client den Hardwareunterbrechung der Warteschlange. Wenn das Gerät einen Hardwareunterbrechung generiert, ruft der Client in der Regel NetRxQueueNotifyMoreReceivedPacketsAvailable über seine EVT_WDF_INTERRUPT_DPC Rückruffunktion auf, nachdem er eine ausstehende NET_PACKET in der NET_RING der Empfangswarteschlange abgeschlossen hat.
Der Client sollte NetRxQueueNotifyMoreReceivedPacketsAvailable nur einmal pro Aktivierung der Benachrichtigung aufrufen. Wenn für den letzten Aufruf von EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLEDNotificationEnabled auf FALSE festgelegt ist, sollte der Client den Aufruf von NetRxQueueNotifyMoreReceivedPacketsAvailable vermeiden. Da NetAdapterCx EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED wiederholt aufruft, kann der Client einige Fälle verpassen und NetRxQueueNotifyMoreReceivedPacketsAvailable aufrufen, wenn NotificationEnabled auf FALSE festgelegt ist. In diesen Fällen ist der Anruf ein No-Op.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1,27 |
| UMDF-Mindestversion | 2.33 |
| Kopfzeile | netrxqueue.h (include netadaptercx.h) |
| IRQL | <= HIGH_LEVEL |