EVT_PACKET_QUEUE_STOP funzione di callback (netpacketqueue.h)

Articolo
08/07/2023

La funzione di callback EvtPacketQueueStop è 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 per una coda di pacchetti.

Valore restituito

nessuno

Osservazioni

Si tratta di un callback facoltativo. Registrare questa funzione di callback nel callback EVT_NET_ADAPTER_CREATE_TX(rxQueueContext)QUEUE . 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_CANCEL o EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED dopo la restituzione di EvtPacketQueueStop . Inoltre, EvtPacketQueueStop viene chiamato nello stesso contesto di esecuzione o thread, come EvtPacketQueueAdvance, EvtPacketQueueCancel e EvtPacketQueueSetNotificationEnabled, quindi i driver client non devono eseguire la sincronizzazione tra queste funzioni di callback per una singola istanza di coda.

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