aclrtMalloc

函数功能

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

约束说明

• 若涉及媒体数据处理功能，由于媒体数据处理功能对存放输入、输出数据的内存有更高的要求（例如，内存首地址128字节对齐），因此需调用专用的内存申请接口，如下：
  • 调用媒体数据处理V1版本的接口对图片进行抠图、缩放等操作时，调用acldvppMalloc接口申请内存。
  • 调用媒体数据处理V2版本的接口对图片进行抠图、缩放等操作时，调用hi_mpi_dvpp_malloc接口申请内存。
• 本接口分配的内存不会进行对内容进行初始化。
• 本接口内部不会进行隐式的Device同步或流同步。如果申请内存成功或申请内存失败会立刻返回结果。
• 使用aclrtMalloc接口申请的内存，需要通过aclrtFree接口释放内存。
• 频繁调用aclrtMalloc接口申请内存、调用aclrtFree接口释放内存，会损耗性能，建议用户提前做内存预先分配或二次管理，避免频繁申请/释放内存。
• 若用户需申请大块内存并自行划分、管理内存时，建议使用aclrtMallocAlign32接口，该接口相比aclrtMalloc接口，只会对用户申请的size向上对齐成32字节整数倍，不会再多加32字节。

  不管是aclrtMalloc接口，还是aclrtMallocAlign32接口，若用户使用本接口申请大块内存并自行划分、管理内存时，每段内存需同时满足以下需求：

  • 内存大小向上对齐成32整数倍+32字节（m=ALIGN_UP[len,32]+32字节）；
  • 内存起始地址需满足64字节对齐（ALIGN_UP[m,64]）。
  

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

函数原型

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

参数说明

返回值说明

返回0表示成功，返回其它值表示失败。

参考资源

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