---
title: 函数：malloc_align32
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/runtimeapi/aclpythondevg_01_0973.html
sourcePath: /source/zh/canncommercial/900/API/runtimeapi/aclpythondevg_01_0973.html
indexId: dfbf7f9b2f4809b32d9eb57740a6ab5ed4a19c79f1766529fb99501042e8730471
---
# 函数：malloc_align32

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | √ |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | √ |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | √ |
| Atlas 训练系列产品 | √ |
| Atlas 推理系列产品 | √ |
| Atlas 200I/500 A2 推理产品 | √ |


#### 功能说明

在Device上分配size大小的线性内存，并通过“dev_ptr”返回已分配内存的指针。本接口分配的内存会进行字节对齐，会对用户申请的size向上对齐成32字节整数倍。使用本接口申请的内存，需要通过acl.rt.free接口释放内存。

与acl.rt.malloc接口相比，本接口只会对用户申请的size向上对齐成32字节整数倍，不会再多加32字节。


#### 函数原型

- C函数原型
  1 aclError aclrtMallocAlign32(void **devPtr, size_t size, aclrtMemMallocPolicy policy)

- python函数
  1 dev_ptr, ret = acl.rt.malloc_align32(size, policy)


#### 参数说明

| 参数名 | 说明 |
| --- | --- |
| size | int，申请内存的大小，单位Byte。size不能为0。 |
| policy | int，内存分配规则。 若配置的内存分配规则超出aclrtMemMallocPolicy取值范围，size≥2M时，按大页申请内存，否则按普通页申请内存。 |


#### 返回值说明

| 返回值 | 说明 |
| --- | --- |
| dev\_ptr | int，指向Device上已分配内存的指针地址。 |
| ret | int，错误码，返回0表示成功，返回其它值表示失败。 |


#### 约束说明

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

  - 调用    媒体数据处理V1(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/dvpp/aclpythondevg_01_0219.html)
版本的接口对图片进行抠图、缩放等操作时，调用    acl.media.dvpp_malloc(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/dvpp/aclpythondevg_01_0223.html)
接口申请内存。
  - 调用    媒体数据处理V2(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/dvpp/aclpythondevg_01_0410.html)
版本的接口对图片进行抠图、缩放等操作时，调用    acl.himpi.dvpp_malloc(https://www.hiascend.comdocument/detail/zh/canncommercial/900/API/dvpp/aclpythondevg_01_0416.html)
接口申请内存。

- 本接口分配的内存不会进行对内容进行初始化。

- 本接口内部不会进行隐式的Device同步或流同步。如果申请内存成功或申请内存失败会立刻返回结果。
- 使用acl.rt.malloc_align32接口申请的内存，需要通过  acl.rt.free
接口释放内存。
- 频繁调用acl.rt.malloc_align32接口申请内存、调用  acl.rt.free
接口释放内存，会损耗性能，建议用户提前做内存预先分配或二次管理，避免频繁申请/释放内存。
- 若用户使用本接口申请大块内存并自行划分、管理内存时，每段内存需同时满足以下需求：

  - 内存大小向上对齐成32整数倍+32字节（m=ALIGN_UP[len,32]+32字节）；
  - 内存起始地址需满足64字节对齐（ALIGN_UP[m,64]）。
len表示某段内存的大小，ALIGN_UP[len,k]表示向上按k字节对齐：((len-1)/k+1)*k。