EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED callback function

Warning

Some information in this topic relates to prereleased product, which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

NetAdapterCx is preview only in Windows 10, version 1903.

The EvtPacketQueueSetNotificationEnabled callback function is implemented by the client driver to perform client-specific processing when there are new packets received in the specified queue's ring buffer.

Syntax

EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED EvtPacketQueueSetNotificationEnabled;

void EvtPacketQueueSetNotificationEnabled(
  NETPACKETQUEUE PacketQueue,
  BOOLEAN NotificationEnabled
)
{...}

Parameters

PacketQueue

A handle to a packet queue.

NotificationEnabled

A value of TRUE requests that the client enable packet queue notification. A value of FALSE requests that the client disable packet queue notification.

Return Value

This callback function does not return a value.

Remarks

Register this callback function in your EVT_NET_ADAPTER_CREATE_TX(RX)QUEUE callback. Set the appropriate member of a NET_PACKET_QUEUE_CONFIG structure when you are initializing the structure with NET_PACKET_QUEUE_CONFIG_INIT, then call NetTx(Rx)QueueCreate.

NetAdapterCx serializes this callback function along with the packet queue's EVT_PACKET_QUEUE_CANCEL and EVT_PACKET_QUEUE_ADVANCE callback functions.

For more info and a diagram showing the NetAdapterCx data path polling model, see Transmit and receive queues.

Requirements

   
Target Platform Universal
Minimum KMDF version 1.27
Header netpacketqueue.h
IRQL PASSIVE_LEVEL

See Also

EVT_NET_ADAPTER_CREATE_RXQUEUE

EVT_NET_ADAPTER_CREATE_TXQUEUE

NetRxQueueCreate

NetTxQueueCreate

EVT_PACKET_QUEUE_START

EVT_PACKET_QUEUE_ADVANCE

EVT_PACKET_QUEUE_CANCEL

EVT_PACKET_QUEUE_STOP

NetTxQueueNotifyMoreCompletedPacketsAvailable

NetRxQueueNotifyMoreReceivedPacketsAvailable