---
title: aclrtGetMemInfo
description: "获取指定属性的AscendCL应用可用内存的空闲大小和总大小，不包括系统预留内存大小。同步接口。"
url: https://www.hiascend.com/document/detail/zh/Atlas200IDKA2DeveloperKit/latest/Application%20Development%20Guide/aadgc/aclcppdevg_03_0108.html
sourcePath: /source/zh/Atlas200IDKA2DeveloperKit/23.0.RC2/Application Development Guide/aadgc/aclcppdevg_03_0108.html
indexId: 6a34a5c65bf8ddb670a753c7af01e649f98b56695d3974d3e28120be9cfbbbff105
---
# aclrtGetMemInfo

#### 函数功能

获取指定属性的AscendCL应用可用内存的空闲大小和总大小，不包括系统预留内存大小。同步接口。

请根据实际硬件支持的情况，选择对应属性的内存，否则调用本接口获取到的空闲大小和总大小都为0。


#### 约束说明

调用本接口前是必须先指定用于计算的Device（例如调用aclrtSetDevice接口指定用于计算的Device），因此本接口中不体现Device ID。


#### 函数原型

aclError aclrtGetMemInfo(aclrtMemAttr attr, size_t *free, size_t *total)


#### 参数说明

| 参数名 | 输入/输出 | 说明 |
| --- | --- | --- |
| attr | 输入 | 需要查询的内存的属性值。 |
| free | 输出 | 对应属性内存空闲大小的指针，单位Byte。 |
| total | 输出 | 对应属性内存总大小的指针，单位Byte。 |


#### 返回值说明

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