CreateRxBuffers

The CreateRxBuffers 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) Receive Buffers.

Syntax

RTND_BUFFER_HEADER *(*CreateRxBuffers)(
    RTND_INTERFACE_OBJECT *pNL2InterfaceObject, 
    ULONG RxQueueIndex, 
    ULONG BufferCount
)

Parameters

pNL2InterfaceObject

An opaque pointer to the interface object provided by an NL2 call to RtndManageInterface.

RxQueueIndex

The index of the Receive Queue for which the buffers are allocated.

BufferCount

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 RtndAllocateRxFrameDataBuffers 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
• RtndAllocateRxFrameDataBuffers
• RtndStartInterface