(netpacketqueue.h) EVT_PACKET_QUEUE_STOP 回呼函式

發行項
02/26/2024

EvtPacketQueueStop 回呼函式是選擇性回呼，由客戶端驅動程序實作，以停止封包佇列的數據路徑。

語法

EVT_PACKET_QUEUE_STOP EvtPacketQueueStop;

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

參數

[_In_] PacketQueue

封包佇列的句柄。

傳回值

無

備註

這是選擇性回呼。在您的 EVT_NET_ADAPTER_CREATE_TX (rxQueueContext) QUEUE 回呼中註冊此回呼函式。使用 NET_PACKET_QUEUE_CONFIG_INIT 初始化結構之後，請設定NET_PACKET_QUEUE_CONFIG結構的適當成員，然後呼叫 NetTx (rxQueueContext) QueueCreate。

此回呼不會傳回值，因此不應該失敗，因此此回呼應該是快速執行的輕量函式。

在 EvtPacketQueueStop 傳回之後，客戶端驅動程式將不會收到對EVT_PACKET_QUEUE_ADVANCE、EVT_PACKET_QUEUE_CANCEL或EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED的呼叫。此外， EvtPacketQueueStop 會在與 EvtPacketQueueAdvance、 EvtPacketQueueCancel 和 EvtPacketQueueSetNotificationEnabled 相同的執行內容或線程中呼叫，因此客戶端驅動程式不需要在這些回呼函式之間同步處理個別佇列實例。

如需詳細資訊和顯示 NetAdapterCx 數據路徑輪詢模型的圖表，請參閱傳輸和接收佇列。