ReadSpmBuffer

产 品 支 持 情 况

产 品	是 否 支 持
Ascend 950PR/Ascend 950DT	√
Atlas A3 训 练 系 列 产 品/Atlas A3 推 理 系 列 产 品	√
Atlas A2 训 练 系 列 产 品/Atlas A2 推 理 系 列 产 品	√
Atlas 200I/500 A2 推 理 产 品	x
Atlas 推 理 系 列 产 品AI Core	√
Atlas 推 理 系 列 产 品Vector Core	x
Atlas 训 练 系 列 产 品	√
Kirin X90	√
Kirin 9030	√

功 能 说 明

从SPM Buffer读 回 到local数 据 中。

函 数 原 型

• 适 用 于 连 续 和 不 连 续 的 数 据 回 读：

  Text

  template <typename T>
  __aicore__ inline void ReadSpmBuffer(const LocalTensor<T>& readBuffer, const DataCopyParams& copyParams, int32_t readOffset = 0)
  

• 适 用 于 连 续 的 数 据 回 读：

  Text

  template <typename T>
  __aicore__ inline void ReadSpmBuffer(const LocalTensor<T>& readBuffer, const int32_t readSize, int32_t readOffset = 0)
  

参 数 说 明

表 1 接 口 参 数 说 明

参 数 名 称	输 入/输 出	含 义
readBuffer	输 入	读 回 的 目 标local内 存。
copyParams	输 入	搬 运 参 数，DataCopyParams类 型，DataCopyParams结 构 定 义 请 参 考表2。
readSize	输 入	读 回 的 元 素 个 数。
readOffset	输 入	SPM Buffer的 偏 移，单 位 为 字 节。

表 2 DataCopyParams结 构 体 参 数 定 义

参 数 名 称	含 义
blockCount	待 搬 运 的 连 续 传 输 数 据 块 个 数。uint16_t类 型，取 值 范 围：blockCount∈[1, 4095]。
blockLen	待 搬 运 的 每 个 连 续 传 输 数 据 块 长 度，单 位 为DataBlock（32字 节）。uint16_t类 型，取 值 范 围：blockLen∈[1, 65535]。
srcGap	源 操 作 数 相 邻 连 续 数 据 块 的 间 隔（前 面 一 个 数 据 块 的 尾 与 后 面 数 据 块 的 头 的 间 隔），单 位 为DataBlock（32字 节）。uint16_t类 型，srcGap不 要 超 出 该 数 据 类 型 的 取 值 范 围。
dstGap	目 的 操 作 数 相 邻 连 续 数 据 块 间 的 间 隔（前 面 一 个 数 据 块 的 尾 与 后 面 数 据 块 的 头 的 间 隔），单 位 为DataBlock（32字 节）。uint16_t类 型，dstGap不 要 超 出 该 数 据 类 型 的 取 值 范 围。

约 束 说 明

无

返 回 值 说 明

无

调 用 示 例

调 用 样 例 请 参 考调 用 示 例。