EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED callback function

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

None

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