aclrtMallocHostWithCfg

产品支持情况

产品

是否支持

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

Atlas 200I/500 A2 推理产品

Atlas 推理系列产品

Atlas 训练系列产品

Atlas 200/300/500 推理产品

功能说明

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

Ascend RC形态下,调用该接口申请的是Device内存,且Device上的内存按普通页申请,如需首地址64字节对齐,需要用户自行处理对齐。

函数原型

aclError aclrtMallocHostWithCfg(void **ptr, uint64_t size, aclrtMallocConfig *cfg)

参数说明

参数名

输入/输出

说明

ptr

输出

“已分配内存的指针”的指针。

size

输入

申请内存的大小,单位Byte。

size不能为0。

cfg

输入

内存配置信息。

不指定配置时,此处可传NULL。

返回值说明

返回0表示成功,返回其他值表示失败,请参见aclError