aclrtMallocHost

产品支持情况

产品

是否支持

Ascend 950PR/Ascend 950DT

√

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

√

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

√

Atlas 200I/500 A2 推理产品

√

Atlas 推理系列产品

√

Atlas 训练系列产品

√

功能说明

申请Host内存(该内存是锁页内存),由系统保证内存首地址64字节对齐。

通过本接口申请的内存,需要通过aclrtFreeHost接口或aclrtFreeHostWithDevSync接口释放内存。

本接口为封装接口,仅适用于C++程序,接口内部调用C接口aclrtMallocHostWithCfg。

函数原型

1
2
template <typename T>
aclError aclrtMallocHost(T **hostPtr, size_t size, aclrtMallocConfig *cfg = nullptr)

参数说明

参数名

输入/输出

说明

hostPtr

输出

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

size

输入

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

size不能为0。

policy

输入

内存分配规则。类型定义请参见aclrtMemMallocPolicy。

若配置的内存分配规则超出aclrtMemMallocPolicy取值范围,size≥2M时,按大页申请内存,否则按普通页申请内存。

cfg

输入

内存配置信息。类型定义请参见aclrtMallocConfig。

返回值说明

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