---
title: GetMeanTmpBufferFactorSize
description: "该接口用于获取maxLiveNodeCnt和extraBuf，在固定空间大小的情况下，通过maxLiveNodeCnt和extraBuf可以推算算子单次最大计算元素数量。maxLiveNodeCnt表示临时空间是单次计算数据量所占空间的多少倍；extraBuf表示使用的额外临时空间大小。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/ascendcopapi/atlasascendc_api_07_0831.html
sourcePath: /source/zh/canncommercial/900/API/ascendcopapi/atlasascendc_api_07_0831.html
indexId: 7883813fcba159730366001dfbfe6085e0da5c303259e817ef05c28503fcdd8e76
---
# GetMeanTmpBufferFactorSize

#### 功能说明

该接口用于获取maxLiveNodeCnt和extraBuf，在固定空间大小的情况下，通过maxLiveNodeCnt和extraBuf可以推算算子单次最大计算元素数量。maxLiveNodeCnt表示临时空间是单次计算数据量所占空间的多少倍；extraBuf表示使用的额外临时空间大小。

推算示例如下：

- 算子实现需要调用Mean接口，开发者为其预留currBuff大小的空间，利用GetMeanTmpBufferFactorSize接口得到maxLiveNodeCnt、extraBuf输出值，可推导算子单次最大计算元素数量为：
  currentShapeSize = (currBuff - extraBuf) / maxLiveNodeCnt / typeSize

- 算子实现需要调用两个kernel侧API KernelIntf1、KernelIntf2，利用两个GetXxxTmpBufferFactorSize（其中Xxx为需要调用的两个高阶API）接口的两组输出值(maxLiveNodeCnt、extraBuf)以及当前现有的临时空间，推导单次最大计算元素数量currentShapeSize为：
  currentShapeSize1 = (currBuff - extraBuf1) / maxLiveNodeCnt1 / typeSize

  currentShapeSize2 = (currBuff - extraBuf2) / maxLiveNodeCnt2 / typeSize

  currentShapeSize = min(currentShapeSize1 , currentShapeSize2)


注意上文中的currBuff表示接口计算可用的空间，需要去除用户输入输出等空间。


#### 函数原型

```
void GetMeanTmpBufferFactorSize(const uint32_t typeSize, uint32_t& maxLiveNodeCount, uint32_t& extraBuffer)
```


#### 参数说明


**表1 参数列表**

| 接口 | 输入/输出 | 功能 |
| --- | --- | --- |
| typeSize | 输入 | 输入的数据类型大小，单位为字节。比如输入的数据类型为half，此处应传入2。 |
| maxLiveNodeCount | 输出 | 最大存活节点数，表示临时空间是单次计算数据量所占空间的多少倍。 |
| extraBuffer | 输出 | 使用的额外临时空间大小，单位为byte。 |


#### 返回值说明

无


#### 约束说明

当利用maxLiveNodeCount，extraBuffer反推出的currentShapeSize * typeSize < 256B时，currentShapeSize按照256B/typeSize的值向上取整。


#### 调用示例

完整的调用样例请参考更多样例。```
uint32_t maxLiveNodeCnt = 0;
uint32_t extraBuf = 0;
AscendC::GetMeanTmpBufferFactorSize(typeSize, maxLiveNodeCnt, extraBuf);
```