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