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

#### 产品支持情况

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


#### 功能说明

获取当前Device下所有Stream上任务的溢出状态，并将状态值拷贝到用户申请的Device内存中。异步接口。


#### 函数原型

- C函数原型
  1 aclError aclrtGetOverflowStatus(void *outputAddr, size_t outputSize, aclrtStream stream)

- python函数
  1 ret = acl.rt.get_overflow_status(outputAddr, outputSize, stream)


#### 参数说明

| 参数名 | 说明 |
| --- | --- |
| outputAddr | int，用户申请的Device内存，需通过acl.rt.malloc接口申请。如果需要在Host侧查看数据，可调用acl.rt.memcpy或acl.rt.memcpy\_async接口，将Device侧的数据传输到Host侧。 |
| outputSize | int，需申请的Device内存大小，单位Byte，固定大小为64Byte。 |
| stream | int，指定Stream的指针地址，用于下发溢出状态查询任务。 |


#### 返回值说明

| 返回值 | 说明 |
| --- | --- |
| ret | int，错误码，返回0表示成功，返回其它值表示失败。 |


#### 约束说明

该接口是异步接口，调用接口成功仅表示任务下发成功，不表示任务执行成功。调用该接口后，需调用同步等待接口（例如，acl.rt.synchronize_stream）确保任务已执行完成。

Atlas A2 训练系列产品 / Atlas A2 推理系列产品 上，调用本接口查询出来的溢出状态是进程级别的。

Atlas A3 训练系列产品 / Atlas A3 推理系列产品 上，调用本接口查询出来的溢出状态是进程级别的。