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

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


#### 产品支持情况

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


#### 功能说明

该接口用于通知HCCL通信域取消使用预留的虚拟内存。


#### 函数原型

```
HcclResult HcclCommUnsetMemoryRange(HcclComm comm, void *baseVirPtr)
```


#### 参数说明

| 参数名 | 输入/输出 | 描述 |
| --- | --- | --- |
| comm | 输入 | HCCL通信域，建议使用Server内最大的通信域，即覆盖最大卡数的通信域。 |
| baseVirPtr | 输入 | 预留的虚拟内存基地址。 指定的基地址需已成功执行HcclCommSetMemoryRange，否则会报错。 |


#### 返回值

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


#### 约束说明

如果本虚拟地址空间内仍存在激活的内存，此接口会执行失败。