tfPoolReceive

Jump to: navigation, search

Table of Contents >> Programmer's Reference


#include <trsocket.h>


int tfPoolReceive (
ttUserInterface interfaceHandle,
char TM_FAR * TM_FAR * dataPtrPtr,
int TM_FAR * dataLengthPtr,
ttUserBufferPtr bufHandlePtr
);


Function Description

Remove first received buffer, from the pool receive queue. Store in dataPtrPtr, dataLengthPtr, bufHandlePtr, the buffer data pointer, data length, and buffer handle respectively. This function could be the drvRecvFuncPtr parameter to tfAddInterface(). Otherwise the user calls this function from the device driver receive function. The parameters are identical to the device driver receive function.


Parameters

  • interfaceHandle
    Interface handle as returned by tfAddInterface().
  • dataPtrPtr
    Pointer to the area where to store the buffer data pointer.
  • dataLengthPtr
    Pointer to the area where to store the buffer data length.
  • bufHandlePtr
    Pointer to the area where to store the buffer handle.


Returns

  • TM_DEV_OKAY
    Success.
  • TM_DEV_ERROR
    No buffers in the pool receive queue.


Table of Contents >> Programmer's Reference