acl.himpi.dvpp_malloc

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

dev_ptr, ret = acl.himpi.dvpp_malloc(dev_id, size)

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

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

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

dev_id：Device设备号，预留参数，该参数配置无效。

标准形态下，在Host上调用本接口时，DVPP内部根据pyACL接口acl.rt.set_device的device申请内存。

size：申请内存的大小，单位Byte。

ret：int，错误码。

• 返回0表示成功。
• 返回非0表示失败，参见公共返回码。

dev_ptr：int，指向Device上已分配内存的指针地址。

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

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