EVT_PACKET_QUEUE_STOP funzione di callback (netpacketqueue.h)

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 in 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 callback. Impostare il membro appropriato di una struttura 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 riuscire, quindi questo callback deve essere una funzione di peso leggero 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 il ritorno di EvtPacketQueueStop. Inoltre, EvtPacketQueueStop viene chiamato nello stesso contesto di esecuzione o thread, come EvtPacketQueueAdvance, EvtPacketQueueCancel e EvtPacketQueueSetNotificationEnabled, quindi i driver client non devono sincronizzare tra queste funzioni di callback per un'istanza singola coda.

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

Requisiti

Vedi anche

EVT_NET_ADAPTER_CREATE_RXQUEUE

EVT_NET_ADAPTER_CREATE_TXQUEUE

NetRxQueueCreate

NetTxQueueCreate

EVT_PACKET_QUEUE_START

EVT_PACKET_QUEUE_ADVANCE

EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED

EVT_PACKET_QUEUE_CANCEL