Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The client driver calls NetTxQueueNotifyMoreCompletedPacketsAvailable to resume queue operations after NetAdapterCx calls the client's EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED event callback routine.
Syntax
void NetTxQueueNotifyMoreCompletedPacketsAvailable(
[_In_] NETPACKETQUEUE PacketQueue
);
Parameters
[_In_] PacketQueue
A handle to a net transmit queue.
Return value
None
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.
Requirements
Requirement | Value |
---|---|
Target Platform | Universal |
Minimum KMDF version | 1.27 |
Minimum UMDF version | 2.33 |
Header | nettxqueue.h (include netadaptercx.h) |
IRQL | <= HIGH_LEVEL |