hi_mpi_dvpp_malloc

函数功能

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

昇腾310 AI处理器，当前版本该接口预留。

昇腾910 AI处理器，当前版本该接口预留。

约束说明

• 调用该接口申请内存后，这部分内存的生命周期由用户自行管理，如果不使用，必须调用hi_mpi_dvpp_free接口及时释放内存。通过该接口申请的内存仅支持在单个进程内使用，不能在多个进程之间共享。
• 昇腾310 AI处理器，关于系统内预留大页的说明请参见总体说明。
• 媒体数据处理的输出作为模型推理的输入时，若用户使用本接口申请大块内存并自行划分、管理内存时，每段内存需满足：

  按每张图片的实际数据大小向上对齐成32整数倍+32字节（ALIGN_UP[len]+32字节）来管理内存，内存起始地址需满足各功能的内存对齐要求（参考以下说明），如果多个功能串联使用时，内存首地址需满足最大对齐值。

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

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

  

  VPC功能，输入、输出内存首地址均要求16对齐，但128对齐时性能更优；

  JPEGD功能，输入、输出内存首地址均要求128对齐；

  JPEGE功能，输入内存首地址要求128对齐，输出内存首地址无对齐要求；

  VDEC功能，输入内存首地址无对齐要求，输出内存首地址要求16对齐；

  VENC功能，输入内存首地址要求16对齐，输出内存首地址无对齐要求；

  PNGD功能，输入内存首地址无对齐要求，输出内存首地址要求128对齐。

函数原型

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

参数说明

返回值说明

• 0：成功
• 非0：失败