---
title: HcclCommDeactivateCommMemory
description: "本接口为试用接口，后续可能存在变更，暂不支持应用于生产环境。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/hcclug/hcclcpp_07_0057.html
sourcePath: /source/zh/canncommercial/900/API/hcclug/hcclcpp_07_0057.html
indexId: 9744b5f5a10f35979a8ae58814750df6500f12c866cdd11cc8445f3655dc543761
---
# HcclCommDeactivateCommMemory

本接口为试用接口，后续可能存在变更，暂不支持应用于生产环境。


#### 产品支持情况

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


#### 功能说明

将已经激活的虚拟内存反激活，反激活后如果再使用该地址进行集合通信，将不会启用零拷贝功能。


#### 函数原型

```
HcclResult HcclCommDeactivateCommMemory(HcclComm comm, void *virPtr)
```


#### 参数说明

| 参数名 | 输入/输出 | 描述 |
| --- | --- | --- |
| comm | 输入 | HCCL通信域，建议使用Server内最大的通信域，即覆盖最大卡数的通信域。 |
| virPtr | 输入 | 需要反激活的虚拟地址的起始地址，即HcclCommActivateCommMemory接口“virPtr”参数指定的虚拟内存地址。 需要注意，指定的虚拟内存必须是已成功激活的内存，且仅支持整个地址块反激活。 |


#### 返回值

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


#### 约束说明

无
