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接口配对使用。
  • 本接口不能与集合通信、点对点通信的相关接口并发执行。