1.1.8.3 WDRV_WINC_ICMPEchoRequest Function

WDRV_WINC_STATUS WDRV_WINC_ICMPEchoRequest (

DRV_HANDLE handle, uint32_t ipAddress, uint8_t ttl,

const WDRV_WINC_ICMP_ECHO_RSP_EVENT_HANDLER pfICMPEchoResponseCB

)

C

Summary

Sends an ICMP echo request.

Description

Sends an ICMP echo request packet to the IP specified.

Precondition

WDRV_WINC_Initialize should have been called. WDRV_WINC_Open should have been called to obtain a valid handle. The WINC must not be connected.

Parameters

Param

Description

handle

Client handle obtained by a call to WDRV_WINC_Open.

ipAddress

IPv4 address.

ttl

The Time-to-live value.

pfICMPEchoResponseCB

Callback for ICMP address events.

Returns

WDRV_WINC_STATUS_OK - The request has been accepted. WDRV_WINC_STATUS_NOT_OPEN - The driver instance is not open. WDRV_WINC_STATUS_INVALID_ARG - The parameters were incorrect. WDRV_WINC_STATUS_REQUEST_ERROR - The request to the WINC was rejected.

Remarks

None.