EVT_NET_ADAPTER_CREATE_TXQUEUE callback function (netadapter.h)

The client driver's implementation of the EvtNetAdapterCreateTxQueue event callback function that sets up a transmit (Tx) queue.

Syntax

EVT_NET_ADAPTER_CREATE_TXQUEUE EvtNetAdapterCreateTxqueue;

NTSTATUS EvtNetAdapterCreateTxqueue(
  [_In_]    NETADAPTER Adapter,
  [_Inout_] NETTXQUEUE_INIT *TxQueueInit
)
{...}

Parameters

[_In_] Adapter

The network adapter object that the client created in a prior call to NetAdapterCreate.

[_Inout_] TxQueueInit

A pointer to a NetAdapterCx-allocated NETTXQUEUE_INIT structure. For more information, see the Remarks section.

Return value

If the operation is successful, the callback function must return STATUS_SUCCESS, or another status value for which NT_SUCCESS(status) equals TRUE. Otherwise, an appropriate NTSTATUS error code.

Remarks

To register an EVT_NET_ADAPTER_CREATE_TXQUEUE callback function, the client driver must call NetAdapterCreate.

The NETTXQUEUE_INIT structure is an opaque structure that is defined and allocated by NetAdapterCx, similar to WDFDEVICE_INIT.

In this callback, the client driver might call NetTxQueueInitGetQueueId to retrieve the identifier of the transmit queue to set up. Next, the client calls NetTxQueueCreate to allocate a queue. If NetTxQueueCreate fails, the EvtNetAdapterCreateTxQueue callback function should return an error code.

NetAdapterCx calls EvtNetAdapterCreateTxQueue at the very end of the power-up sequence.

For a code example of implementing this callback function, see Transmit and receive queues.

Requirements

Requirement	Value
Target Platform	Universal
Minimum KMDF version	1.29
Minimum UMDF version	2.33
Header	netadapter.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL