NetRxQueueNotifyMoreReceivedPacketsAvailable-Funktion (netrxqueue.h)

Der Clienttreiber ruft NetRxQueueNotifyMoreReceivedPacketsVerfügbarkeit 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 Abfrage deaktiviert ist.

Nachdem NetAdapterCx die EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED Ereignisrückrufroutine eines Clienttreibers aufruft, wobei NotificationEnabled auf TRUE festgelegt ist, aktiviert der Client die Hardwareunterbrechung der Warteschlange. Wenn das Gerät einen Hardware-Interrupt generiert, ruft der Client in der Regel NetRxQueueNotifyMoreReceivedPacketsAvailable über seine EVT_WDF_INTERRUPT_DPC Rückruffunktion auf, nachdem er eine ausstehende NET_PACKET im 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 nicht op.

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1,27
Kopfzeile netrxqueue.h (include netadaptercx.h)
IRQL <= HIGH_LEVEL

Weitere Informationen

EVT_PACKET_QUEUE_ADVANCE

EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED