aclrtMallocCached
函数功能
在Device上申请size大小的线性内存,通过*devPtr返回已分配内存的指针,同步接口,该接口在任何场景下申请的内存都是支持cache缓存。
使用aclrtMallocCached接口申请的内存与使用aclrtMalloc接口申请的内存是等价的,都支持cache缓存。
调用媒体数据处理的接口前,若需要申请Device上的内存存放输入或输出数据,需调用acldvppMalloc申请内存。
约束说明
其它约束与aclrtMalloc接口相同。
函数原型
aclError aclrtMallocCached(void **devPtr, size_t size, aclrtMemMallocPolicy policy)
参数说明
参数名 |
输入/输出 |
说明 |
---|---|---|
devPtr |
输出 |
“Device上已分配内存的指针”的指针。 |
size |
输入 |
申请内存的大小,单位Byte。 size不能为0。 |
policy |
输入 |
内存分配规则。 typedef enum aclrtMemMallocPolicy { ACL_MEM_MALLOC_HUGE_FIRST, // 当申请的内存小于等于1M时,即使使用该内存分配规则,也是申请普通页的内存。当申请的内存大于1M时,优先申请大页内存,如果大页内存不够,则使用普通页的内存。 ACL_MEM_MALLOC_HUGE_ONLY, // 仅申请大页,如果大页内存不够,则返回错误。 ACL_MEM_MALLOC_NORMAL_ONLY, // 仅申请普通页。 ACL_MEM_MALLOC_HUGE_FIRST_P2P, //仅Device之间内存复制场景下申请内存时使用该选项,表示优先申请大页内存,如果大页内存不够,则使用普通页的内存。昇腾310 AI处理器,当前版本不支持该选项。 ACL_MEM_MALLOC_HUGE_ONLY_P2P, //仅Device之间内存复制场景下申请内存时使用该选项,仅申请大页内存,如果大页内存不够,则返回错误。昇腾310 AI处理器,当前版本不支持该选项。 ACL_MEM_MALLOC_NORMAL_ONLY_P2P, //仅Device之间内存复制场景下申请内存时使用该选项,仅申请普通页的内存。昇腾310 AI处理器,当前版本不支持该选项。 } aclrtMemMallocPolicy; |
返回值说明
返回0表示成功,返回其它值表示失败。
父主题: 内存管理