RtndGetTxBuffers
RtndGetTxBuffers gets multiple buffers from the driver's pool of available transmit buffers.
Syntax
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: