Share via

NetTxQueueNotifyMoreCompletedPacketsAvailable 函式 (nettxqueue.h)

  • 發行項

用戶端驅動程式會呼叫 NetTxQueueNotifyMoreCompletedPacketsAvailable ，以在 NetAdapterCx 呼叫 用戶端EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED事件 回呼例程之後繼續佇列作業。

語法

void NetTxQueueNotifyMoreCompletedPacketsAvailable(
  [_In_] NETPACKETQUEUE PacketQueue
);

參數

[_In_] PacketQueue

Net 傳輸佇列的句柄。

傳回值

無

備註

只有在停用輪詢時，才應該呼叫此函式。

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
標頭 nettxqueue.h (包括 netadaptercx.h)
IRQL <= HIGH_LEVEL

另請參閱

EVT_PACKET_QUEUE_ADVANCE

EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED