www.beck-ipc.com

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


RegisterIPCallbackHandler

Register an IP User callback handler.

int RegisterIPCallbackHandler ( void far *funcptr );

Parameters

funcptr

Pointer to user's IP callback Handler.

Return Value

0 = success

Comments

This function allows the application programmer to install a ip packet filter callback function. The application programmer can implement a function from the type described below:

typedef int (huge *IPSortOutFuncPtr)( IpUserCallbackInfo_t *ipInfo );

If a function of this type is installed by the user, the TCPIP stack will call this function at any incoming ip packet. Inside of this function the user is able to check the given IP parameters and decide, if the TCPIP stack should process this packet or ignore it. If the callback function returns -1 the incoming packet will be ignored by the TCPIP stack.

To uninstall the callback function, this API call must be called with a null pointer.
!Do not forget to uninstall the function, if your application exits!

See Also

RTOS API

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


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


End of document