企业官网建设流程全解析

9. CntNotify管理

【免费下载链接】runtime本项目提供CANN运行时组件和维测功能组件。项目地址: https://gitcode.com/cann/runtime

本章节描述 CANN Runtime 的 CntNotify（计数型通知）管理接口，用于 CntNotify 的创建、记录、等待及销毁。

• aclError aclrtCntNotifyCreate(aclrtCntNotify *cntNotify, uint64_t flag)：创建CntNotify。
• aclError aclrtCntNotifyRecord(aclrtCntNotify cntNotify, aclrtStream stream, aclrtCntNotifyRecordInfo *info)：在指定Stream上记录一个CntNotify。异步接口。
• aclError aclrtCntNotifyWaitWithTimeout(aclrtCntNotify cntNotify, aclrtStream stream, aclrtCntNotifyWaitInfo *info)：阻塞指定Stream的运行，直到指定的CntNotify完成。异步接口。
• aclError aclrtCntNotifyReset(aclrtCntNotify cntNotify, aclrtStream stream)：复位一个CntNotify，将CntNotify的计数值清空为0。异步接口。
• aclError aclrtCntNotifyGetId(aclrtCntNotify cntNotify, uint32_t *notifyId)：获取CntNotify的ID。
• aclError aclrtCntNotifyDestroy(aclrtCntNotify cntNotify)：销毁CntNotify。

aclrtCntNotifyCreate

aclError aclrtCntNotifyCreate(aclrtCntNotify *cntNotify, uint64_t flag)

产品支持情况

功能说明

创建CntNotify。

CntNotify通常也用于Device与Device之间的状态/动作通信通知。但CntNotify是利用计数值实现任务间的同步，跟Notify的区别是，Notify的计数值仅支持1，CntNotify的计数值支持[1~uint32_t最大值]。

参数说明

返回值说明

返回0表示成功，返回其他值表示失败，请参见aclError。

aclrtCntNotifyRecord

aclError aclrtCntNotifyRecord(aclrtCntNotify cntNotify, aclrtStream stream, aclrtCntNotifyRecordInfo *info)

产品支持情况

功能说明

在指定Stream上记录一个CntNotify。异步接口。

aclrtCntNotifyRecord接口与aclrtCntNotifyWaitWithTimeout接口配合使用时，主要用于多Stream之间同步等待的场景。

参数说明

返回值说明

返回0表示成功，返回其他值表示失败，请参见aclError。

aclrtCntNotifyWaitWithTimeout

aclError aclrtCntNotifyWaitWithTimeout(aclrtCntNotify cntNotify, aclrtStream stream, aclrtCntNotifyWaitInfo *info)

产品支持情况

功能说明

阻塞指定Stream的运行，直到指定的CntNotify完成。异步接口。

参数说明

返回值说明

返回0表示成功，返回其他值表示失败，请参见aclError。

aclrtCntNotifyReset

aclError aclrtCntNotifyReset(aclrtCntNotify cntNotify, aclrtStream stream)

产品支持情况

功能说明

复位一个CntNotify，将CntNotify的计数值清空为0。异步接口。

参数说明

返回值说明

返回0表示成功，返回其他值表示失败，请参见aclError。

aclrtCntNotifyGetId

aclError aclrtCntNotifyGetId(aclrtCntNotify cntNotify, uint32_t *notifyId)

产品支持情况

功能说明

获取CntNotify的ID。

参数说明

返回值说明

返回0表示成功，返回其他值表示失败，请参见aclError。

aclrtCntNotifyDestroy

aclError aclrtCntNotifyDestroy(aclrtCntNotify cntNotify)

产品支持情况

功能说明

销毁CntNotify。

参数说明

返回值说明

返回0表示成功，返回其他值表示失败，请参见aclError。

【免费下载链接】runtime本项目提供CANN运行时组件和维测功能组件。项目地址: https://gitcode.com/cann/runtime