HcclCommUnsetMemoryRange
说明
本接口为试用接口,后续可能存在变更,暂不支持应用于商用产品。
产品支持情况
- Ascend 950PR/Ascend 950DT:不支持
- Atlas A3 训练系列产品/Atlas A3 推理系列产品:支持
- Atlas A2 训练系列产品/Atlas A2 推理系列产品:不支持
- Atlas 推理系列产品:不支持
- Atlas 训练系列产品:不支持
功能说明
该接口用于通知HCCL通信域取消使用预留的虚拟内存。
函数原型
HcclResult HcclCommUnsetMemoryRange(HcclComm comm, void *baseVirPtr)
参数说明
| 参数名 | 输入/输出 | 描述 |
|---|---|---|
| comm | 输入 | HCCL通信域,建议使用Server内最大的通信域,即覆盖最大卡数的通信域。 |
| baseVirPtr | 输入 | 预留的虚拟内存基地址。 指定的基地址需已成功执行HcclCommSetMemoryRange,否则会报错。 |
返回值
HcclResult:接口成功返回HCCL_SUCCESS,其他失败。
约束说明
如果本虚拟地址空间内仍存在激活的内存,此接口会执行失败。