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 aufruft.
Syntax
void NetRxQueueNotifyMoreReceivedPacketsAvailable(
[_In_] NETPACKETQUEUE PacketQueue
);
Parameter
[_In_] PacketQueue
Ein Handle für ein Net Receive Queue-Objekt.
Rückgabewert
Nichts
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 mit NotificationEnabled- auf TRUEfestgelegt hat, ermöglicht der Client die Hardwareunterbrechung der Warteschlange. Wenn das Gerät einen Hardwareunterbruch generiert, ruft der Client in der Regel NetRxQueueNotifyMoreReceivedPacketsAvailable aus seiner EVT_WDF_INTERRUPT_DPC Rückruffunktion auf, nachdem eine ausstehende NET_PACKET im NET_RINGder Empfangswarteschlange abgeschlossen wurde.
Der Client sollte nur NetRxQueueNotifyMoreReceivedPacketsAvailable einmal pro Aktivierung der Benachrichtigung aufrufen. Wenn der letzte Aufruf von EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLEDNotificationEnabled auf FALSE-festgelegt ist, sollte der Client das Aufrufen von NetRxQueueNotifyMoreReceivedPacketsAvailablevermeiden. 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- | Universal |
| Minimale KMDF-Version | 1.27 |
| Mindest-UMDF-Version | 2.33 |
| Header- | netrxqueue.h (include netadaptercx.h) |
| IRQL- | <= HIGH_LEVEL |