HccnRpingBatchPingStart
Applicable Products
Product |
Supported |
|---|---|
√ |
|
√ |
|
√ |
|
☓ |
|
☓ |
|
☓ |
Description
Starts a ping request.
Prototype
1 | HccnResult HccnRpingBatchPingStart(HccnRpingCtx rpingCtx, uint32_t pktNum, uint32_t interval, uint32_t timeout) |
Parameters
Parameter |
Input/Output |
Description |
|---|---|---|
rpingCtx |
Input |
RPing object returned by the HccnRpingInit API. |
pktNum |
Input |
Number of packets sent to each ping target. The value must be greater than 0 and less than buffer_size / 2048 / targets during RPing initialization. |
interval |
Input |
Packet TX interval, in milliseconds. The value range is (0, 1000). If the packet TX interval is too short, the receiver may receive a large number of ping packets within a short period. This may cause delayed software processing or NIC packet loss, leading to inaccurate delay measurement. |
timeout |
Input |
Timeout, in milliseconds. If no pong packet is received within the specified period, the packet is considered lost and the delay is not counted in the RTT result. The value must be greater than 0. |
Returns
Parsing result of the error code of the HccnResult type.
Constraints
This API cannot be called repeatedly. If you want to start a new ping task, call HccnRpingBatchPingStop to stop the current ping task, and call HccnRpingBatchPingStart.