CANN/asc-devkit Cube资源组假消息发送API

PostFakeMsg

【免费下载链接】asc-devkit本项目是CANN 推出的昇腾AI处理器专用的算子程序开发语言，原生支持C和C++标准规范，主要由类库和语言扩展层构成，提供多层级API，满足多维场景算子开发诉求。项目地址: https://gitcode.com/cann/asc-devkit

产品支持情况

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

功能说明

通过AllocMessage接口获取到消息空间地址后，AIV发送假消息，刷新消息状态msgState为FAKE。

当多个AIV的消息内容一致时，AIC仅需要读取一次位置靠前的第一个消息，通过将消息结构体中自定义的参数skipCnt设置为n，通知AIC后续n条消息无需处理，直接跳过，被跳过的AIV需要使用本接口发送假消息，这被称之为消息合并机制或消息合并场景。

如下图所示，假设Queue1、2、3的第0条消息与Queue0的第0条消息相同，在消息合并场景中，从AIC视角来看，Queue0(0)，Queue4(0)的消息会被处理，并根据用户自定义的消息内容完成相应的AIC上的计算。Queue1(0), Queue2(0), Queue3(0)由于发了假消息，AIC将不会读取消息内容进行计算，直接释放消息。

图 1PostFakeMessage示意图
![](https://raw.gitcode.com/cann/asc-devkit/raw/68eb55191616e7a7b08961a5c82a706272353b5f/docs/api/figures/PostFakeMessage示意图.png "PostFakeMessage示意图"?utm_source=gitcode_repo_files)

函数原型

__aicore__ inline uint16_t PostFakeMsg(__gm__ CubeMsgType* msg)

参数说明

表 1接口参数说明

参数	输入/输出	说明
msg	输入	该CubeResGroupHandle中某个任务的消息空间地址。

返回值说明

当前消息空间与该消息队列队首空间的地址偏移。

约束说明

无

调用示例

hanndle.AssignQueue(queIdx); auto msgPtr = handle.AllocMessage(); // 获取消息空间指针msgPtr auto offset = handle.PostFakeMsg(msgPtr); // 在msgPtr指针位置，发送假消息

【免费下载链接】asc-devkit本项目是CANN 推出的昇腾AI处理器专用的算子程序开发语言，原生支持C和C++标准规范，主要由类库和语言扩展层构成，提供多层级API，满足多维场景算子开发诉求。项目地址: https://gitcode.com/cann/asc-devkit