@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
|