CreateTxBuffers

The CreateTxBuffers function pointer is contained in the RTND_CALLBACKS structure. It is meant to be called by a driver to allocate a new set of Network Link Layer (NL2) Transmit Buffers.

Syntax

RTND_BUFFER_HEADER *(*CreateTxBuffers)(
    RTND_INTERFACE_OBJECT *pNL2InterfaceObject, 
    ULONG TxQueueIndex, 
    ULONG BufferCount
)

Parameters

pNL2InterfaceObject

An opaque pointer to the interface object in RTND_INTERFACE_OBJECT, which has been provided by a Network Link Layer (NL2) call to RtndManageInterface.

TxQueueIndex

The index of the Physical Transmit Queue for which the buffers are allocated.

ULONG

The number of buffers to allocate. The function returns the head of a linked list of the buffer headers associated with the allocated NL2 Buffers.

Remarks

This callback calls the driver's RtndAllocateTxFrameDataBuffers function to allocate the frame data buffers. The headers are allocated by the NL2.

Important: The driver must only call this callback from RtndStartInterface. Calling it from other locations may result in undefined behavior.

Requirements

See Also:

• RTND_CALLBACKS
• RtndManageInterface
• RtndAllocateTxFrameDataBuffers
• RtndStartInterface