HccnRpingGetResult

Applicability

Product

Supported

Atlas 350 Accelerator Card

Atlas A3 training product/Atlas A3 inference product

Atlas A2 training product/Atlas A2 inference product

Atlas 200I/500 A2 inference product

Atlas inference product

Atlas training product

Description

Obtains the target ping result.

Prototype

1
HccnResult HccnRpingGetResult(HccnRpingCtx rpingCtx, uint32_t targetNum, HccnRpingTargetInfo *target, HccnRpingResultInfo *result)

Parameters

Parameter

Input/Output

Description

rpingCtx

Input

RPing object returned by the HccnRpingInit API.

targetNum

Input

Number of targets to be obtained. The value must be less than or equal to the number of added targets.

target

Input

Target to be obtained.

For details about the definition of the HccnRpingTargetInfo type, see HccnRpingTargetInfo.

result

Output

Obtained ping result.

For the definition of the HccnRpingResultInfo type, see HccnRpingResultInfo.

Returns

Parsing result of the error code of the HccnResult type.

Constraints

  • The value of targetNum must be the same as the target array size. Otherwise, out-of-bounds access may occur.
  • The value of targetNum cannot be greater than the total number of ping targets.
  • This API does not support deduplication of the target array. Ensure that the target array does not contain duplicate information.
  • Ping results of a maximum of 16 targets can be obtained at once. If results of more than 16 targets need to be obtained, call this API for multiple times.