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)

参数说明

返回值说明

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

参考资源

接口调用流程及示例，参见DVPP图像/视频处理（媒体数据处理V1）。