---
title: InitSpmBuffer
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/ascendcopapi/atlasascendc_api_07_0166.html
sourcePath: /source/zh/canncommercial/900/API/ascendcopapi/atlasascendc_api_07_0166.html
indexId: cf59a8bca2fc2381efeb5ebe452d2bf6f0b2cf25e29805531aa6706da12fbbd976
---
# InitSpmBuffer

#### 产品支持情况

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


#### 功能说明

初始化SPM Buffer。


#### 函数原型

- 暂存到workspace初始化，需要指定GM地址为SPM Buffer：
  1 2 template <typename T> __aicore__ inline void InitSpmBuffer(const GlobalTensor<T>& workspace, const int32_t bufferSize)

- 暂存到L1 Buffer初始化，不需要指定地址，会默认暂存到L1 Buffer，只需要传入需要的SPM Buffer大小：
  1 __aicore__ inline void InitSpmBuffer(const int32_t bufferSize)

  Atlas A2 训练系列产品 / Atlas A2 推理系列产品 ，不支持暂存到L1 Buffer初始化接口。

  Atlas A3 训练系列产品 / Atlas A3 推理系列产品 ，不支持暂存到L1 Buffer初始化接口。


#### 参数说明

| 参数名 | 输入/输出 | 含义 |
| --- | --- | --- |
| workspace | 输入 | workspace地址。 |
| bufferSize | 输入 | SPM Buffer的大小，单位是字节。 |


#### 约束说明

无


#### 返回值说明

无


#### 调用示例

- 暂存到workspace初始化
  1 2 3 4 5 AscendC::TPipe pipe; int len = 1024; // 设置spm buffer为1024个类型为T的数据 workspace_gm.SetGlobalBuffer((__gm__ T *)usrWorkspace, len); // 此处的usrWorkspace为用户自定义的workspace auto gm = workspace_gm[AscendC::GetBlockIdx() * len]; pipe.InitSpmBuffer(gm, len * sizeof(T));

- 暂存到L1 Buffer初始化
  1 2 3 AscendC::TPipe pipe; int len = 1024; // 设置spm buffer为1024个类型为T的数据 pipe.InitSpmBuffer(len * sizeof(T));