EVT_NET_ADAPTER_CREATE_RXQUEUE 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 EvtNetAdapterCreateRxQueue event callback function that sets up a receive (Rx) queue.

Syntax

EVT_NET_ADAPTER_CREATE_RXQUEUE EvtNetAdapterCreateRxqueue;

NTSTATUS EvtNetAdapterCreateRxqueue(
  NETADAPTER Adapter,
  NETRXQUEUE_INIT *RxQueueInit
)
{...}

Parameters

Adapter

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

RxQueueInit

A pointer to a NetAdapterCx-allocated NETRXQUEUE_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_RXQUEUE callback function, the client driver must call NetAdapterCreate.

The NETRXQUEUE_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 NetRxQueueInitGetQueueId to retrieve the identifier of the receive queue to set up. Next, the client calls NetRxQueueCreate to allocate a queue. If NetRxQueueCreate fails, the EvtNetAdapterCreateRxQueue callback function should return an error code.

NetAdapterCx calls EvtNetAdapterCreateRxQueue 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