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

Siehe auch

EVT_PACKET_QUEUE_ADVANCE

EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED