---
title: HcclCommSuspend
description: "本接口为预留接口，后续有可能变更，不支持开发者使用。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/hcclug/hcclcpp_07_0017.html
sourcePath: /source/zh/canncommercial/900/API/hcclug/hcclcpp_07_0017.html
indexId: 430c316a2fb400613ec3071228a6e1629aa6931438db96fc07593a98f07ac02661
---
# HcclCommSuspend

本接口为预留接口，后续有可能变更，不支持开发者使用。


#### 产品支持情况

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


针对 Atlas A2 训练系列产品 / Atlas A2 推理系列产品 ，仅支持Atlas 800T A2 训练服务器、Atlas 900 A2 PoD 集群基础单元、Atlas 200T A2 Box16 异构子框。


#### 功能说明

当片上内存UCE（uncorrect error）故障时（ACL接口返回ACL_ERROR_RT_DEVICE_MTE_ERROR错误码），可调用本接口将通信域置为挂起状态。

使用此接口挂起通信域，无需退出Host侧进程，后续故障修复后，可调用HcclCommResume接口恢复通信域状态。


#### 函数原型

```
HcclResult HcclCommSuspend(HcclComm comm)
```


#### 参数说明

| 参数名 | 输入/输出 | 描述 |
| --- | --- | --- |
| comm | 输入 | 需要将状态置为挂起的通信域。 HcclComm类型的定义可参见HcclComm。 |


#### 返回值

HcclResult：接口成功返回HCCL_SUCCESS，其他失败。


#### 约束说明

- 本接口需要与  HcclCommResume
接口配对使用。
- 本接口不能与  集合通信
、  点对点通信
的相关接口并发执行。