Skip to content

Latest commit

 

History

History
68 lines (53 loc) · 3.27 KB

nf-nettxqueue-nettxqueuenotifymorecompletedpacketsavailable.md

File metadata and controls

68 lines (53 loc) · 3.27 KB
UID title description tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.lib req.dll req.irql req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.alt-api req.alt-loc targetos f1_keywords topic_type api_type api_location api_name
NF:nettxqueue.NetTxQueueNotifyMoreCompletedPacketsAvailable
NetTxQueueNotifyMoreCompletedPacketsAvailable function (nettxqueue.h)
The client driver calls NetTxQueueNotifyMoreCompletedPacketsAvailable to resume queue operations after NetAdapterCx calls the client's EVT_TXQUEUE_SET_NOTIFICATION_ENABLED event callback routine.
netvista
04/01/2022
NetTxQueueNotifyMoreCompletedPacketsAvailable function
NetTxQueueNotifyMoreCompletedPacketsAvailable
nettxqueue.h
netadaptercx.h
Universal
1.27
2.33
<= HIGH_LEVEL
Windows
NetTxQueueNotifyMoreCompletedPacketsAvailable
nettxqueue/NetTxQueueNotifyMoreCompletedPacketsAvailable
apiref
HeaderDef
nettxqueue.h
NetTxQueueNotifyMoreCompletedPacketsAvailable

NetTxQueueNotifyMoreCompletedPacketsAvailable function

-description

The client driver calls NetTxQueueNotifyMoreCompletedPacketsAvailable to resume queue operations after NetAdapterCx calls the client's EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED event callback routine.

-parameters

-param PacketQueue [In]

A handle to a net transmit queue.

-remarks

This function should only be called when polling is disabled.

After NetAdapterCx calls a client driver's EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED event callback routine with NotificationEnabled set to TRUE, the client enables the queue's hardware interrupt. When the device generates a hardware interrupt, the client typically calls NetTxQueueNotifyMoreCompletedPacketsAvailable from its *EVT_WDF_INTERRUPT_DPC callback function, after it completes a pending NET_PACKET in the transmit queue's NET_RING.

The client should only call NetTxQueueNotifyMoreCompletedPacketsAvailable once per enabling of the notification. If the most recent call to EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED has NotificationEnabled set to FALSE, the client should avoid invoking NetTxQueueNotifyMoreCompletedPacketsAvailable. Because NetAdapterCx invokes EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED repeatedly, the client may miss a few cases and call NetTxQueueNotifyMoreCompletedPacketsAvailable when NotificationEnabled is set to FALSE. In these cases, the call will be a no-op.

-see-also

EVT_PACKET_QUEUE_ADVANCE

EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED