NetTxQueueNotifyMoreCompletedPacketsAvailable-Funktion (nettxqueue.h)
Der Clienttreiber ruft NetTxQueueNotifyMoreCompletedPacketsAvailable auf, um Warteschlangenvorgänge fortzusetzen, nachdem NetAdapterCx die EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED Ereignisrückrufroutine des Clients aufruft.
Syntax
void NetTxQueueNotifyMoreCompletedPacketsAvailable(
[_In_] NETPACKETQUEUE PacketQueue
);
Parameter
[_In_] PacketQueue
Ein Handle für eine Netzübertragungswarteschlange.
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 NetTxQueueNotifyNotifyMoreCompletedPacketsAvailable von seiner *EVT_WDF_INTERRUPT_DPC Rückruffunktion auf, nachdem eine ausstehende NET_PACKET in der NET_RINGder Übertragungswarteschlange abgeschlossen wurde.
Der Client sollte NetTxQueueNotifyMoreCompletedPacketsAvailable nur 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 NetTxQueueNotifyMoreCompletedPacketsAvailablevermeiden. Da NetAdapterCx EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED wiederholt aufruft, kann der Client einige Fälle verpassen und NetTxQueueNotifyNotifyMoreCompletedPacketsAvailable 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- | nettxqueue.h (include netadaptercx.h) |
| IRQL- | <= HIGH_LEVEL |