acldvppMalloc

函数功能

该接口主要用于分配内存给Device侧媒体数据处理时使用，申请的大页内存满足数据处理的要求（例如，内存首地址128对齐），同步接口。调用该接口申请内存后，必须使用acldvppFree接口释放内存。

约束说明

• 频繁调用acldvppMalloc接口申请内存、调用acldvppFree接口释放内存，会损耗性能，建议用户提前做内存预先分配或二次管理，避免频繁申请/释放内存。
• 调用acldvppMalloc接口申请内存时，会对用户输入的size按向上对齐成32整数倍后，再多加32字节。
  

  若用户使用acldvppMalloc接口申请大块内存并自行划分、管理内存时，每段内存需满足：按每张图片的实际数据大小向上对齐成32整数倍+32字节（ALIGN_UP[len]+32字节）来管理内存，内存起始地址需满足64字节对齐。

  例如，用户已使用acldvppMalloc接口申请大块内存并自行管理内存，用户需管理n张图片的内存，每张图片大小为len字节，实际应按照n*(ALIGN_UP[len]+32字节)的大小管理内存，每张图片的内存地址按(ALIGN_UP[len]+32字节)为单位偏移。

  ALIGN_UP表示向上按32字节对齐：((len-1)/32+1)*32。

• 调用该接口申请大页内存失败，仅表示系统内的大页内存不够。昇腾310 AI处理器，关于系统内预留大页的说明请参见总体说明。

函数原型

aclError acldvppMalloc(void **devPtr, size_t size)

参数说明

返回值说明

返回0表示成功，返回其它值表示失败。

参考资源

• 接口调用流程，参见媒体数据处理V1。
• 接口调用示例，参见媒体数据处理V1。