昇腾社区首页
中文
注册

函数:free_host

产品支持情况

产品

是否支持

Atlas A3 训练系列产品 / Atlas A3 推理系列产品

Atlas A2 训练系列产品 / Atlas 800I A2 推理产品 /A200I A2 Box 异构组件

Atlas 训练系列产品

Atlas 推理系列产品

Atlas 200I/500 A2 推理产品

Atlas 200/300/500 推理产品

功能说明

释放Host上的内存。

函数原型

  • C函数原型
    1
    aclError aclrtFreeHost(void *hostPtr)
    
  • python函数
    1
    ret= acl.rt.free_host(host_ptr)
    

参数说明

参数名

说明

host_ptr

int,待释放内存的指针地址。

返回值说明

返回值

说明

ret

int,错误码,返回0表示成功,返回其它值表示失败。

约束说明

  • 本接口会立刻释放传入的内存,函数内部不会进行隐式的Device同步或流同步。用户需要确保调用完本接口后不再对该内存指针地址进行访问。
  • acl.rt.free_host接口只能释放通过acl.rt.malloc_host接口申请的内存。

资源参考

接口调用示例,参见数据传输