hi_mpi_dvpp_malloc
Atlas 200/300/500 推理产品,不支持该接口。
Atlas 训练系列产品,不支持该接口。
函数功能
申请Device上的内存,申请的内存满足媒体数据处理的要求(例如,内存首地址128字节对齐)。
约束说明
- 调用该接口申请内存后,这部分内存的生命周期由用户自行管理,如果不使用,必须调用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。
参数说明
参数名 |
输入/输出 |
说明 |
---|---|---|
dev_id |
输入 |
Device ID,预留参数,该参数配置无效。 标准形态下,在Host上调用本接口时,DVPP内部根据AscendCL接口aclrtSetDevice的device申请内存。 |
dev_ptr |
输出 |
“Device上已分配内存的指针”的指针。 |
size |
输入 |
申请内存的大小,单位Byte。 |
返回值说明
- 0:成功
- 非0:失败
父主题: 公共接口