asc_datacache_preload

产 品 支 持 情 况

产 品	是 否 支 持
Ascend 950PR/Ascend 950DT	√
Atlas A3 训 练 系 列 产 品/Atlas A3 推 理 系 列 产 品	√
Atlas A2 训 练 系 列 产 品/Atlas A2 推 理 系 列 产 品	√

功 能 说 明

从 源 地 址 所 在 的 特 定GM地 址 预 加 载 数 据 到Data Cache中。

函 数 原 型

C++

__aicore__ inline void asc_datacache_preload(__gm__ uint64_t* address, int64_t offset)

参 数 说 明

参 数 名	输 入/输 出	描 述
address	输 入	源 操 作 数 的 起 始 地 址。
offset	输 入	在 源 操 作 数 上 偏 移offset大 小 开 始 加 载 数 据，单 位 为Bytes。

返 回 值 说 明

无

流 水 类 型

PIPE_S

约 束 说 明

频 繁 调 用 此 接 口 可 能 会 导 致 保 留 栈 拥 塞，此 时，该 接 口 将 被 视 为NOP指 令，阻 塞Scalar流 水。因 此 不 建 议 频 繁 调 用 此 接 口。

调 用 示 例

C++

__gm__ uint64_t addr[256];
int64_t offset = 0;
asc_datacache_preload(addr, offset);