NetTxQueueNotifyMoreCompletedPacketsAvailable 函式 (nettxqueue.h)
用戶端驅動程式會呼叫 netTxQueueNotifyMoreCompletedPacketsAvailable,以在 NetAdapterCx 呼叫用戶端 EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED 事件回呼例程之後,繼續佇列作業。
語法
void NetTxQueueNotifyMoreCompletedPacketsAvailable(
[_In_] NETPACKETQUEUE PacketQueue
);
參數
[_In_] PacketQueue
網路傳輸佇列的句柄。
傳回值
沒有
言論
只有在停用輪詢時,才應該呼叫此函式。
在 NetAdapterCx 呼叫用戶端驅動程式的 EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED 事件回呼例程後,NotificationEnabled 設為 TRUE,用戶端會啟用佇列的硬體中斷。 當裝置產生硬體中斷時,用戶端通常會從其 *EVT_WDF_INTERRUPT_DPC 回呼函式呼叫 NetTxQueueNotifyMoreCompletedPacketsAvailable,在傳輸佇列 NET_RING中完成擱置 NET_PACKET 之後。
客戶端應該只針對啟用通知一次呼叫 NetTxQueueNotifyMoreCompletedPacketsAvailable 一次。 如果最近對 EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED 的呼叫 NotificationEnabled 設為 FALSE,則客戶端應該避免叫用 netTxQueueNotifyMoreCompletedPacketsAvailable。 因為 NetAdapterCx 會重複叫用 EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED,用戶端可能會遺漏幾個情況,並在 NotificationEnabled 設定為 FALSE時呼叫 NetTxQueueNotifyMoreCompletedPacketsAvailableable。 在這些情況下,呼叫會是 no-op。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
最低 KMDF 版本 | 1.27 |
最低 UMDF 版本 | 2.33 |
標頭 | nettxqueue.h (包括 netadaptercx.h) |
IRQL | <= HIGH_LEVEL |