hi_mpi_dvpp_malloc

产品支持情况

功能说明

申请Device上的内存，申请的内存满足媒体数据处理的要求（例如，内存首地址128字节对齐）。调用本接口申请内存时，会对用户输入的size按向上对齐成32整数倍后，再多加32字节。调用该接口申请内存后，这部分内存的生命周期由用户自行管理，如果不使用，必须调用hi_mpi_dvpp_free接口及时释放内存。

函数原型

hi_s32 hi_mpi_dvpp_malloc(hi_u32 dev_id, hi_void **dev_ptr, hi_u64 size)

参数说明

返回值说明

• 0：成功
• 非0：失败

约束说明

• 通过该接口申请的内存仅支持在单个进程内使用，不能在多个进程之间共享。
• 媒体数据处理功能在每个进程内，可访问的地址空间最大为16GB。

  该约束适用于以下产品：

  Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件

  Atlas 推理系列产品

• 媒体数据处理的输出作为模型推理的输入时，若用户使用本接口申请大块内存并自行划分、管理内存时，每段内存需同时满足以下要求：
  • 内存大小向上对齐成32整数倍+32字节（m=ALIGN_UP[len,32]+32字节）；
  • 内存起始地址需满足128字节对齐（ALIGN_UP[m,128]）。
  

  len表示某段内存的大小，ALIGN_UP[len,k]表示向上按k字节对齐：((len-1)/k+1)*k。

参考资源

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