EVT_PACKET_QUEUE_STOP funzione di callback (netpacketqueue.h)

Articolo
02/07/2025

Il EvtPacketQueueStop funzione di callback è un callback facoltativo implementato dal driver client per arrestare il percorso dei dati per una coda di pacchetti.

Sintassi

EVT_PACKET_QUEUE_STOP EvtPacketQueueStop;

void EvtPacketQueueStop(
  [_In_] NETPACKETQUEUE PacketQueue
)
{...}

Parametri

[_In_] PacketQueue

Handle di una coda di pacchetti.

Valore restituito

Nessuno

Osservazioni

Questo è un callback facoltativo. Registrare questa funzione di callback nel callback EVT_NET_ADAPTER_CREATE_TX(rxQueueContext)QUEUE callback. Impostare il membro appropriato di una struttura di NET_PACKET_QUEUE_CONFIG dopo aver inizializzato la struttura con NET_PACKET_QUEUE_CONFIG_INIT, quindi chiamare NetTx(rxQueueContext)QueueCreate.

Questo callback non restituisce un valore e pertanto non deve avere esito negativo, pertanto questo callback deve essere una funzione leggera che viene eseguita rapidamente.

I driver client non riceveranno chiamate a EVT_PACKET_QUEUE_ADVANCE, EVT_PACKET_QUEUE_CANCELo EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED dopo che EvtPacketQueueStop restituisce. Inoltre, EvtPacketQueueStop viene chiamato nello stesso contesto di esecuzione o thread, come EvtPacketQueueAdvance, EvtPacketQueueCancele EvtPacketQueueSetNotificationEnabled, quindi i driver client non devono sincronizzare tra queste funzioni di callback per una singola istanza della coda.

Per altre info e un diagramma che mostra il modello di polling del percorso dati NetAdapterCx, vedere Trasmettere e ricevere code.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.27
versione minima di UMDF	2.33
intestazione	netpacketqueue.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL