NetTxQueueNotifyMoreCompletedPacketsAvailable-Funktion (nettxqueue.h)

  • Artikel

Der Clienttreiber ruft NetTxQueueNotifyMoreCompletedPacketsAvailable auf, um Warteschlangenvorgänge fortzusetzen, nachdem NetAdapterCx die EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED Ereignisrückrufroutine des Clients aufgerufen hat.

Syntax

void NetTxQueueNotifyMoreCompletedPacketsAvailable(
  [_In_] NETPACKETQUEUE PacketQueue
);

Parameter

[_In_] PacketQueue

Ein Handle für eine Netzübertragungswarteschlange.

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 NetTxQueueNotifyMoreCompletedPacketsAvailable über seine Rückruffunktion *EVT_WDF_INTERRUPT_DPC auf, nachdem er eine ausstehende NET_PACKET im NET_RING der Übertragungswarteschlange abgeschlossen hat.

Der Client sollte NetTxQueueNotifyMoreCompletedPacketsAvailable 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 NetTxQueueNotifyMoreCompletedPacketsAvailable vermeiden. Da NetAdapterCx EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED wiederholt aufruft, kann der Client einige Fälle verpassen und NetTxQueueNotifyMoreCompletedPacketsAvailable 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
Kopfzeile nettxqueue.h (include netadaptercx.h)
IRQL <= HIGH_LEVEL

Weitere Informationen

EVT_PACKET_QUEUE_ADVANCE

EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED