---
title: HccnRpingInit
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/others/rpingdev/hccnrpingapi_07_0002.html
sourcePath: /source/zh/canncommercial/900/others/rpingdev/hccnrpingapi_07_0002.html
indexId: 532b00a5dc787fffdd718dc1a236af34d012921feb872d8a6adf8b7fccd96b7e71
---
# HccnRpingInit

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | √ |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | √ |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | √ |
| Atlas 200I/500 A2 推理产品 | ☓ |
| Atlas 推理系列产品 | ☓ |
| Atlas 训练系列产品 | ☓ |


#### 功能说明

初始化参与RPing的Device，启动网络状态监测。


#### 函数原型

```
HccnResult HccnRpingInit(uint32_t devLogicId, HccnRpingInitAttr *initAttr, HccnRpingCtx *rpingCtx)
```


#### 参数说明

| 参数名 | 输入/输出 | 描述 |
| --- | --- | --- |
| devLogicId | 输入 | 参与RPing功能并进行资源初始化的Device的逻辑ID。 |
| initAttr | 输入 | RPing功能的初始化配置信息。 HccnRpingInitAttr类型的定义可参见HccnRpingInitAttr。 |
| rpingCtx | 输出 | 构造的RPing对象的指针。 HccnRpingCtx类型的定义可参见HccnRpingCtx。 |


#### 返回值

HccnResult类型错误码的解析结果。


#### 约束说明

- 使用该接口前需要调用aclrtSetDevice接口指定参与RPing功能的Device。
- 该接口会申请堆上内存来存储相关资源，RPing功能关闭后需要用户调用  HccnRpingDeinit
接口释放资源。
- 针对Atlas A2 训练系列产品 / Atlas A2 推理系列产品，Atlas A3 训练系列产品 / Atlas A3 推理系列产品，单个进程中每个Device只能初始化一次。
- 不支持多线程同时初始化一个Device。
- 针对Atlas 350 加速卡，单个进程每个端口只能初始化一次。