www.beck-ipc.com

@CHIP-RTOS C Library V2.06 - TCP/IP API


Dev_Get_Buffer

Get a buffer from TCP/IP stack's pre-allocated buffer for storing incoming data from this device.

int Dev_Get_Buffer( DevUserBufferHandle BufHandlePtr,
                     char far * far * buffer,
                     unsigned int length);

Parameters

BufHandlePtr

Output Parameter:   Pointer to location where this function will on success set a handle to the allocated buffer.   This handle is used internally by the @Chip-RTOS TCP/IP stack to manage the subsequent release of this allocated buffer.

buffer

Output Parameter:   Pointer to a variable of type DevUserBufferHandle where the user buffer handle is stored.   (This value is for internal use.)

length

Number of bytes buffer required

Return Value

0: success , *buffer points to the beginning of the allocated buffer
-1: Allocation failed, *buffer is a null pointer.

See Also

RTOS API

This library function invokes a RTOS software interrupt. Refer to this RTOS API function's documentation for more details.

Related Topics

Receiver function

Supported since or modified in @CHIP-RTOS version

    SC12SC13SC11SC1x3
    V1.10V1.00V1.00V0.90

This API List
List of C Libraries
@CHIP-RTOS Main Index


End of document