EVT_PACKET_QUEUE_STOP回呼函式（netpacketqueue.h）

發行項
02/07/2025

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 資料路徑輪詢模型的圖表，請參閱傳輸和接收佇列。