NetTxQueueGetExtension function (nettxqueue.h)

The NetTxQueueGetExtension function retrieves a packet extension for all packets in a transmit (Tx) queue.

Syntax

void NetTxQueueGetExtension(
  [_In_]  NETPACKETQUEUE            PacketQueue,
  [_In_]  const NET_EXTENSION_QUERY *Query,
  [_Out_] NET_EXTENSION             *Extension
);

Parameters

[_In_] PacketQueue

The transmit queue object.

[_In_] Query

A pointer to a driver-allocated and initialized NET_EXTENSION_QUERY structure that contains information about the desired packet extension.

[_Out_] Extension

A handle to a driver-allocated NET_EXTENSION structure that receives the packet extension.

Return value

None

Remarks

Client drivers typically call this function from their EvtNetAdapterCreateTxQueue callback function after queue creation. To prevent frequent extension queries, store the extension returned by this function in your queue context space.

For a code example of creating a transmit queue, see Transmit and receive queues.

Requirements

Requirement Value
Target Platform Universal
Minimum KMDF version 1.29
Header nettxqueue.h (include netadaptercx.h)
IRQL PASSIVE_LEVEL

See also

Packet descriptors and extensions