昇腾社区首页
中文
注册

函数:malloc_host_with_cfg

产品支持情况

产品

是否支持

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

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

Atlas 训练系列产品

Atlas 推理系列产品

Atlas 200I/500 A2 推理产品

Atlas 200/300/500 推理产品

功能说明

申请Host内存(该内存是锁页内存),由系统保证内存首地址64字节对齐。与acl.rt.malloc_host接口相比,本接口在申请内存时,还可以指定内存相关的配置信息。

函数原型

  • C函数原型
    1
    aclError aclrtMallocHostWithCfg(void **ptr, uint64_t size, aclrtMallocConfig *cfg)
    
  • python函数
    1
    host_ptr, ret= acl.rt.malloc_host_with_cfg(size, cfg)
    

参数说明

参数名

说明

size

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

cfg

dict,内存配置信息。不指定配置时,此处可传空字典,具体请参见aclrtMallocConfig

返回值说明

返回值

说明

host_ptr

int,指向Host上已分配内存的指针地址。

ret

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