函数：malloc-内存管理-Runtime（rt）-AscendCL API（Python）-应用开发接口-CANN商用版8.0.RC1开发文档-昇腾社区

相关文章推荐

爱旅游的长颈鹿 · 灰色系列 - 萌娘百科萬物皆可萌的百科全書· 6 月前 ·

谦虚好学的消炎药 · 在线访谈-沈阳市人民政府· 10 月前 ·

痴情的啄木鸟 · 散打教研室书记蔡月飞-西安体育学院武术系· 1 年前 ·

大气的剪刀 · 告诸君书 - 知乎· 2 年前 ·

苦恼的闹钟 · 阅读饶宗颐：从天啸楼到梨俱室-中华读书报-光明网· 2 年前 ·

在Device上分配size大小的线性内存，并通过 “dev_ptr” 返回已分配内存的指针地址。本接口分配的内存会进行字节对齐，会对用户申请的size向上对齐成32字节整数倍后再多加32字节。

size ：int，申请内存的大小，单位Byte，size不能为0。

policy ：int，内存分配规则，具体请参见 aclrtMemMallocPolicy 。

返回值说明

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

ret ：int，错误码。

返回0表示成功。

返回其它值表示失败。

由于媒体数据处理功能对存放输入、输出数据的内存有更高的要求（例如，内存首地址128对齐），因此需调用专用的内存申请接口，如下。

调用媒体数据处理V1 版本的接口对图片进行抠图、缩放等操作时，调用 acl.media.dvpp_malloc 接口申请内存。

调用媒体数据处理V2 版本的接口对图片进行抠图、缩放等操作时，调用 acl.himpi.dvpp_malloc 接口申请内存。

本接口分配的内存不会进行对内容的初始化，建议在使用内存前先调用 acl.rt.memset 接口先初始化内存，清除内存中的随机数。

本接口内部不会进行隐式的Device同步或流同步。如果申请内存成功或申请内存失败会立刻返回结果。

使用 acl.rt.malloc 接口申请的内存，需要通过 acl.rt.free 接口释放内存。

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

调用 acl.rt.malloc 接口申请内存时，会对用户输入的size按向上对齐成32字节整数倍后，再多加32字节。若用户使用本接口申请大块内存并自行划分、管理内存时，每段内存需同时满足以下需求：

内存大小向上对齐成32整数倍加32字节（m = ALIGN_UP[len, 32] + 32字节）。

内存起始地址需满足64字节对齐（ALIGN_UP[m, 64]）。

len 表示某段内存的大小，ALIGN_UP[len, k]表示向上按k字节对齐：((len - 1) / k + 1) * k。