函数：malloc

Atlas A3 训练系列产品/Atlas A3 推理系列产品

√

Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件

√

Atlas 训练系列产品

√

Atlas 推理系列产品

√

Atlas 200I/500 A2 推理产品

√

Atlas 200/300/500 推理产品

√

aclError aclrtMalloc(void **devPtr, size_t size, aclrtMemMallocPolicy policy)

dev_ptr, ret = acl.rt.malloc(size, policy)

在Device上分配size大小的线性内存，并通过“dev_ptr”返回已分配内存的指针，且内存首地址64字节对齐。本接口分配的内存会进行字节对齐，会对用户申请的size向上对齐成32字节整数倍后再多加32字节。但对于内存申请粒度为1G的大页内存，为节省大页内存，本接口会对用户申请的size仅向上对齐成32字节整数倍，不会再增加32字节。

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

policy：int，内存分配规则。

若配置的内存分配规则超出aclrtMemMallocPolicy取值范围，size≥2M时，按大页申请内存，否则按普通页申请内存。

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。

接口调用示例，参见数据传输。