CANN/asc-devkit PostMessage函数说明

PostMessage

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

产品支持情况

功能说明

通过AllocMessage接口获取到消息空间地址msg后，构造消息结构体CubeMsgType，发送该消息。

函数原型

template <PipeMode pipeMode = PipeMode::SCALAR_MODE> __aicore__ inline uint16_t PostMessage(__gm__ CubeMsgType* msg, CubeMsgType& msgInput)

参数说明

表 1模板参数说明

enum class PipeMode : uint8_t { SCALAR_MODE = 0, // Scalar执行单元往GM上写消息。 MTE3_MODE = 1, // 使用MTE3单元往GM上写消息。 MAX }

表 2接口参数说明

返回值说明

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

约束说明

无

调用示例

handle.AssignQueue(queIdx); auto msgPtr = handle.AllocMessage(); // 获取消息空间指针msgPtr AscendC::CubeGroupMsgHead headA = {AscendC::CubeMsgState::VALID, 0}; AscendC::CubeMsgBody msgA = {headA, 1, 0, 0, false, false, false, false, 0, 0, 0, 0, 0, 0, 0, 0}; auto offset = handle.PostMessage(msgPtr, msgA); // 在msgPtr指针位置，填充用户自定义的消息结构体，并发送

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