hi_mpi_dvpp_malloc

函数功能

申请Device上的内存，申请的内存满足媒体数据处理的要求（例如，内存首地址128字节对齐）。

Atlas 200/300/500 推理产品，不支持该接口。

Atlas 训练系列产品，不支持该接口。

约束说明

• 调用该接口申请内存后，这部分内存的生命周期由用户自行管理，如果不使用，必须调用hi_mpi_dvpp_free接口及时释放内存。
• 通过该接口申请的内存仅支持在单个进程内使用，不能在多个进程之间共享。
• 调用hi_mpi_dvpp_malloc接口申请内存时，会对用户输入的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。

函数原型

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

参数说明

返回值说明

• 0：成功
• 非0：失败

参考资源

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