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 時,用戶端可能會遺漏幾個案例,並呼叫 NetTxQueueNotifyMoreCompletedPacketsAvailable。 在這些情況下,呼叫將是無作業。
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
最低 KMDF 版本 | 1.27 |
最低UMDF版本 | 2.33 |
標頭 | nettxqueue.h (包含 netadaptercx.h) |
IRQL | <= HIGH_LEVEL |