EVT_PACKET_QUEUE_STOP Rückruffunktion (netpacketqueue.h)
Die EvtPacketQueueStop Rückruffunktion 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
Nichts
Bemerkungen
Dies ist ein optionaler Rückruf. Registrieren Sie diese Rückruffunktion in Ihrer EVT_NET_ADAPTER_CREATE_TX(rxQueueContext)QUEUE Rückruf. Legen Sie das entsprechende Element einer NET_PACKET_QUEUE_CONFIG Struktur fest, nachdem Sie die Struktur mit NET_PACKET_QUEUE_CONFIG_INITinitialisiert haben, und rufen Sie dann NetTx(rxQueueContext)QueueCreateauf.
Dieser Rückruf gibt keinen Wert zurück und sollte daher nicht fehlschlagen, daher sollte dieser Rückruf eine leichtgewichtige Funktion sein, die schnell ausgeführt wird.
Clienttreiber empfangen keine Anrufe an EVT_PACKET_QUEUE_ADVANCE, EVT_PACKET_QUEUE_CANCELoder EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED, nachdem EvtPacketQueueStop zurückgegeben wird. Darüber hinaus wird EvtPacketQueueStop- im gleichen Ausführungskontext oder Thread aufgerufen, wie EvtPacketQueueAdvance, EvtPacketQueueCancelund EvtPacketQueueSetNotificationEnabled, sodass Clienttreiber nicht zwischen diesen Rückruffunktionen für eine einzelne Warteschlangeninstanz synchronisiert werden müssen.
Weitere Informationen und ein Diagramm mit dem NetAdapterCx-Datenpfadabfragungsmodell finden Sie unter Übermittlungs- und Empfangswarteschlangen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Minimale KMDF-Version | 1.27 |
| Mindest-UMDF-Version | 2.33 |
| Header- | netpacketqueue.h (include netadaptercx.h) |
| IRQL- | PASSIVE_LEVEL |
Siehe auch
EVT_NET_ADAPTER_CREATE_RXQUEUE
EVT_NET_ADAPTER_CREATE_TXQUEUE