aclrtMallocHost
产品支持情况
产品 |
是否支持 |
|---|---|
Atlas 350 加速卡 |
√ |
√ |
|
√ |
|
√ |
|
√ |
|
√ |
功能说明
申请Host内存（该内存是锁页内存），由系统保证内存首地址64字节对齐。
通过本接口申请的内存，需要通过aclrtFreeHost接口或aclrtFreeHostWithDevSync接口释放内存。
本接口为封装接口，仅适用于C++程序，接口内部调用C接口aclrtMallocHostWithCfg。
函数原型
1 2 | template <typename T> aclError aclrtMallocHost(T **hostPtr, size_t size, aclrtMallocConfig *cfg = nullptr) |
参数说明
参数名 |
输入/输出 |
说明 |
|---|---|---|
devPtr |
输出 |
“Device上已分配内存的指针”的指针。 |
size |
输入 |
申请内存的大小，单位Byte。 size不能为0。 |
policy |
输入 |
内存分配规则。类型定义请参见aclrtMemMallocPolicy。 若配置的内存分配规则超出aclrtMemMallocPolicy取值范围，size≥2M时，按大页申请内存，否则按普通页申请内存。 |
cfg |
输入 |
内存配置信息。类型定义请参见aclrtMallocConfig。 |
返回值说明
返回0表示成功，返回其他值表示失败，请参见aclError。
父主题： C++扩展接口