NetTxQueueCreate function

Creates a net transmit queue object.

Syntax

NTSTATUS NetTxQueueCreate(
  NETTXQUEUE_INIT         *NetTxQueueInit,
  WDF_OBJECT_ATTRIBUTES   *TxQueueAttributes,
  NET_PACKET_QUEUE_CONFIG *Configuration,
  NETPACKETQUEUE          *PacketQueue
);

Parameters

NetTxQueueInit

A pointer to the NETTXQUEUE_INIT structure that the client driver received in EVT_NET_ADAPTER_CREATE_TXQUEUE.

TxQueueAttributes

A pointer to an initialized, caller-allocated 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

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

Remarks

The client calls NetTxQueueCreate from within its EVT_NET_ADAPTER_CREATE_TXQUEUE 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 nettxqueue.h (include netadaptercx.h)
IRQL PASSIVE_LEVEL