昇腾社区首页
中文
注册

函数:malloc_host

C函数原型

aclError aclrtMallocHost(void **hostPtr, size_t size)

Python函数

host_ptr, ret= acl.rt.malloc_host(size)

函数功能

申请Host或Device上的内存,Device上的内存按普通页申请。同步接口。

输入说明

size:int,申请内存的大小,单位Byte。size不能为0。

返回值说明

host_ptr:int,指向Host上已分配内存的指针的指针对象。

ret:int,错误码。

  • 返回0表示成功。
  • 返回其它值表示失败。

约束说明

  • 使用acl.rt.malloc_host接口申请的内存,需要通过acl.rt.free_host接口释放内存。
  • 应用在Host上运行时,调用该接口申请的是Host内存,由系统保证64字节对齐;应用在Device上运行时,调用该接口申请的是Device内存,如需64字节对齐,需要用户自行处理对齐。
  • 频繁调用acl.rt.malloc_host接口申请内存、调用acl.rt.free_host接口释放内存,会损耗性能,建议用户提前做内存预先分配或二次管理,避免频繁申请/释放内存。
  • 若用户使用acl.rt.malloc_host接口申请大块内存并自行划分、管理内存时,用户在管理内存时,每段内存需满足:内存大小向上对齐成32整数倍+32字节,且内存起始地址需满足64字节对齐。

注意事项

参考资源

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