EVT_NET_ADAPTER_CREATE_TXQUEUE 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 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(
  NETADAPTER Adapter,
  NETTXQUEUE_INIT *TxQueueInit
)
{...}

Parameters

Adapter

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

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

   
Target Platform Universal
Minimum KMDF version 1.29
Header netadapter.h
IRQL PASSIVE_LEVEL