HcclCommSuspend
说明
本接口为预留接口,后续有可能变更,不支持开发者使用。
产品支持情况
- Ascend 950PR/Ascend 950DT:不支持
- Atlas A3 训练系列产品/Atlas A3 推理系列产品:支持
- Atlas A2 训练系列产品/Atlas A2 推理系列产品:支持
- Atlas 推理系列产品:不支持
- Atlas 训练系列产品:不支持
功能说明
当片上内存UCE(uncorrect error)故障时(ACL接口返回ACL_ERROR_RT_DEVICE_MTE_ERROR错误码),可调用本接口将通信域置为挂起状态。
使用此接口挂起通信域,无需退出Host侧进程,后续故障修复后,可调用HcclCommResume接口恢复通信域状态。
函数原型
HcclResult HcclCommSuspend(HcclComm comm)
参数说明
| 参数名 | 输入/输出 | 描述 |
|---|---|---|
| comm | 输入 | 需要将状态置为挂起的通信域。 HcclComm类型的定义可参见HcclComm。 |
返回值
HcclResult:接口成功返回HCCL_SUCCESS,其他失败。
约束说明
- 本接口需要与HcclCommResume接口配对使用。
- 本接口不能与集合通信、点对点通信的相关接口并发执行。