acldvppMalloc
函数功能
该接口主要用于分配内存给Device侧媒体数据处理时使用,申请的大页内存满足数据处理的要求(例如,内存首地址128字节对齐),同步接口。
约束说明
- 调用该接口申请内存后,如果内存不使用,需及时调用acldvppFree接口释放内存。
- 频繁调用acldvppMalloc接口申请内存、调用acldvppFree接口释放内存,会损耗性能,建议用户提前做内存预先分配或二次管理,避免频繁申请/释放内存。
- 调用acldvppMalloc接口申请内存时,会对用户输入的size按向上对齐成32整数倍后,再多加32字节。
- 媒体数据处理的输出作为模型推理的输入时,若用户使用本接口申请大块内存并自行划分、管理内存时,每段内存需同时满足以下要求:
- 内存大小向上对齐成32整数倍+32字节(m=ALIGN_UP[len,32]+32字节);
- 内存起始地址需满足128字节对齐(ALIGN_UP[m,128])。
len表示某段内存的大小,ALIGN_UP[len,k]表示向上按k字节对齐:((len-1)/k+1)*k。
- 调用该接口申请大页内存失败,仅表示系统内的大页内存不够。关于系统内预留大页的说明请参见总体说明。
函数原型
aclError acldvppMalloc(void **devPtr, size_t size)
参数说明
参数名 |
输入/输出 |
说明 |
---|---|---|
devPtr |
输出 |
“Device上已分配内存的指针”的指针。 |
size |
输入 |
申请内存的大小,单位Byte。 |
返回值说明
返回0表示成功,返回其他值表示失败。
父主题: 内存申请与释放