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;

参数名

输入/输出

说明

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表示成功，返回其它值表示失败。

父主题： 内存管理