RtndGetTxBuffers

RtndGetTxBuffers gets multiple buffers from the driver's pool of available transmit buffers.

Syntax

Copy
BOOL RtndGetTxBuffers(
  [in]    ULONG_PTR RtndInterfaceId,
  [in]    ULONG TxQueueIndex,
  [in]    ULONG BufferCount,
  [out]   RTND_BUFFER_HEADER **pBufferHeader
);

Parameters

[in] RtndInterfaceId

The number or pointer used to identify the interface. This value is returned by RtndManageInterface.

[in] TxQueueIndex

The index of the Transmit Queue.

[in] BufferCount

The number of buffers to request.

[out] pBufferHeader

The buffer header address of the first buffer received from the driver’s pool of available transmit buffers.

Return Value

If the function succeeds, it returns TRUE. If the function fails, it returns FALSE. To get extended error information, call GetLastError.

Common error codes:

Error code Meaning

ERROR_DEVICE_NO_RESOURCES

The driver’s pool of available transmit buffers is empty or has less than the requested number of buffers.

Remarks

The NL2 always calls this function from the main thread of the NL2 process.

Characteristics

Real-time requirements

Deterministic behavior

Not required

Local memory allocation/deallocation restrictions

Process

External MSpace

Internal MSpace

System

Not allowed

Not allowed

Process

Not allowed

Not allowed

Contiguous memory allocation/deallocation restrictions

Contiguous memory

Not allowed

Requirements

Minimum supported version Header

eRTOS 1.0 SDK

Rtnd.h

See Also: