1.2.8.3 WDRV_WINC_ICMPEchoRequest Function

C

WDRV_WINC_STATUS WDRV_WINC_ICMPEchoRequest
(
DRV_HANDLE handle,
uint32_t ipAddress,
uint8_t ttl,
const WDRV_WINC_ICMP_ECHO_RSP_EVENT_HANDLER pfICMPEchoResponseCB
)

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

ParamDescription
handleClient handle obtained by a call to WDRV_WINC_Open.
ipAddressIPv4 address.
ttlThe Time-to-live value.
pfICMPEchoResponseCBCallback 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.