昇腾社区首页
中文
注册

函数:dvpp_malloc

C函数原型

aclError acldvppMalloc(void **devPtr, size_t size)

Python函数

dev_ptr, ret = acl.media.dvpp_malloc(size)

函数功能

该接口主要用于分配内存给Device侧媒体数据处理时使用,申请的大页内存满足数据处理的要求(例如,内存首地址128对齐),同步接口。调用该接口申请内存后,必须使用acl.media.dvpp_free接口释放内存。

  • 调用acl.media.dvpp_malloc接口申请内存时,会对用户输入的size按向上对齐成32整数倍后,再多加32字节申请,然后再向上对齐到2M的幂次方(幂最小值为1)申请。用户仅能使用size大小向上对齐成32整数倍+32字节的内存,剩余的内存占用的是虚拟地址,用户不能使用。
    说明:

    若用户使用acl.media.dvpp_malloc接口申请大块内存并自行划分、管理内存时,用户在管理内存时,需按每张图片的实际数据大小向上对齐成32整数倍+32字节(ALIGN_UP[len]+32字节)来管理内存。

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

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

  • 调用该接口申请大页内存失败,仅表示系统内的大页内存不够。
  • 对于昇腾310 AI处理器,在标准形态下,若涉及申请Device上的大页内存,需注意,当前版本为防止大页内存不够用,系统内部已提前占用Device上的1940M大页内存,并将这部分大页内存预留出来供用户使用。

输入说明

size:int,申请内存的大小,单位Byte。

返回值说明

dev_ptr:int,“Device上已分配内存的指针”的指针。

ret:int,错误码。
  • 返回0表示成功。
  • 返回其它值表示失败。

约束说明

频繁调用acl.media.dvpp_malloc接口申请内存、调用acl.media.dvpp_free接口释放内存,会损耗性能,建议用户提前做内存预先分配或二次管理,避免频繁申请/释放内存。

注意事项

参考资源