NetRxQueueCreate 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.

Creates a net receive queue object.

Syntax

NTSTATUS NetRxQueueCreate(
  NETRXQUEUE_INIT         *NetRxQueueInit,
  WDF_OBJECT_ATTRIBUTES   *RxQueueAttributes,
  NET_PACKET_QUEUE_CONFIG *Configuration,
  NETPACKETQUEUE          *PacketQueue
);

Parameters

NetRxQueueInit

A pointer to the NETRXQUEUE_INIT structure that the client driver received in its EVT_NET_ADAPTER_CREATE_RXQUEUE callback function.

RxQueueAttributes

A pointer to caller-allocated and initialized WDF_OBJECT_ATTRIBUTES structure. This parameter is optional and can be WDF_NO_OBJECT_ATTRIBUTES. However, if the client driver supplies this parameter, the ParentObject field must be NULL.

Configuration

A pointer to a caller-allocated NET_PACKET_QUEUE_CONFIG structure.

PacketQueue

Return Value

This method returns STATUS_SUCCESS if the operation succeeds. Otherwise, this method may return an appropriate NTSTATUS error code.

Remarks

The client calls NetRxQueueCreate from within its EVT_NET_ADAPTER_CREATE_RXQUEUE event callback function. For info on assigning context space to the new object, see Framework Object Context Space.

The NETPACKETQUEUE object is a standard WDF object. The framework manages its deletion, which occurs when the parent NETADAPTER object is deleted.

Requirements

   
Target Platform Universal
Minimum KMDF version 1.27
Header netrxqueue.h (include netadaptercx.h)
Library NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL