EVT_PACKET_QUEUE_STOP Rückruffunktion (netpacketqueue.h)
Die Rückruffunktion EvtPacketQueueStop ist ein optionaler Rückruf, der vom Clienttreiber implementiert wird, um den Datenpfad für eine Paketwarteschlange zu beenden.
Syntax
EVT_PACKET_QUEUE_STOP EvtPacketQueueStop;
void EvtPacketQueueStop(
[_In_] NETPACKETQUEUE PacketQueue
)
{...}
Parameter
[_In_] PacketQueue
Ein Handle für eine Paketwarteschlange.
Rückgabewert
Keine
Bemerkungen
Dies ist ein optionaler Rückruf. Registrieren Sie diese Rückruffunktion in Ihrem EVT_NET_ADAPTER_CREATE_TX(rxQueueContext)QUEUE-Rückruf . Legen Sie den entsprechenden Member einer NET_PACKET_QUEUE_CONFIG-Struktur fest, nachdem Sie die Struktur mit NET_PACKET_QUEUE_CONFIG_INIT initialisiert haben, und rufen Sie dann NetTx(rxQueueContext)QueueCreate auf.
Dieser Rückruf gibt keinen Wert zurück und sollte daher nicht fehlschlagen. Daher sollte dieser Rückruf eine einfache Funktion sein, die schnell ausgeführt wird.
Clienttreiber erhalten keine Aufrufe von EVT_PACKET_QUEUE_ADVANCE, EVT_PACKET_QUEUE_CANCEL oder EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED , nachdem EvtPacketQueueStop zurückgegeben wurde. Darüber hinaus wird EvtPacketQueueStop im gleichen Ausführungskontext oder Thread als EvtPacketQueueAdvance, EvtPacketQueueCancel und EvtPacketQueueSetNotificationEnabled aufgerufen, sodass Clienttreiber keine Synchronisierung zwischen diesen Rückruffunktionen für eine einzelne Warteschlange instance.
Weitere Informationen und ein Diagramm, das das NetAdapterCx-Datenpfadabrufmodell zeigt, finden Sie unter Übertragen und Empfangen von Warteschlangen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1,27 |
| UMDF-Mindestversion | 2.33 |
| Kopfzeile | netpacketqueue.h (include netadaptercx.h) |
| IRQL | PASSIVE_LEVEL |
Weitere Informationen
EVT_NET_ADAPTER_CREATE_RXQUEUE
EVT_NET_ADAPTER_CREATE_TXQUEUE