Real time embedded FreeRTOS RSS feed 
Homepage FreeRTOS+ Products FreeRTOS Labs Support Forum Contact / Enquiries
FreeRTOS+UDP was removed from the FreeRTOS kernel download from FreeRTOS V10.1.0. See the FreeRTOS+TCP stack, which can be configured for UDP only use, as an alternative.

vApplicationPingReplyHook()

[FreeRTOS Embedded IP Stack API]

FreeRTOS_sockets.h
void vApplicationPingReplyHook( ePingReplyStatus_t eStatus, uint16_t usIdentifier );
		

vApplicationPingReplyHook() is an application defined hook (or callback) function that is called by the IP stack when the stack receives a reply to an ICMP echo (ping) request that was generated using the FreeRTOS_SendPingRequest() function.

Callback functions are implemented by the application writer, but called by the IP stack. The prototype of the callback function must exactly match the prototype above (including the function name).

Parameters:

eStatus   eStatus will be set (by the IP stack) to one of the following values:

Value Description
eSuccess The echo reply was received correctly.
eInvalidChecksum The data received in the echo reply matched that sent in the echo request, but the reply had an incorrect checksum.
eInvalidData The data received in the echo reply did not match that sent in the echo request.

usIdentifier   The identifier received in the echo reply.

Each echo request has a unique identifier to allow replies to be matched to the requests. The FreeRTOS_SendPingRequest() function returns the identifier of the outgoing echo request it generated.

Example usage:

The example on the FreeRTOS_SendPingRequest() documentation page includes an example implementation of vApplicationPingReplyHook().


[ Back to the top ]    [ About FreeRTOS ]    [ Privacy ]    [ FreeRTOS+ Sitemap ]    [ Main FreeRTOS Sitemap ]    [ ]


Copyright (C) Amazon Web Services, Inc. or its affiliates. All rights reserved.