Star521
636
代码
代码
Issues23
Pull Requests114
Actions
项目讨论
Wiki
分析
Star521
636
cann-robotcann-robot【PR】: 简要描述Docs下增加zh目录，更新api_ref目录下的md文件
74980743创建于 26 天前历史提交

9. CntNotify管理

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

aclrtCntNotifyCreate

aclError aclrtCntNotifyCreate(aclrtCntNotify *cntNotify, uint64_t flag)

产品支持情况

  • Ascend 950PR/Ascend 950DT：支持
  • Atlas A3 训练系列产品/Atlas A3 推理系列产品：不支持
  • Atlas A2 训练系列产品/Atlas A2 推理系列产品：不支持
  • Atlas 200I/500 A2 推理产品：不支持
  • Atlas 推理系列产品：不支持
  • Atlas 训练系列产品：不支持
  • IPV350：不支持

功能说明

创建CntNotify。

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

参数说明

参数名 输入/输出 说明
cntNotify 输出 CntNotify的指针。类型定义请参见aclrtCntNotify。
flag 输入 预留参数，当前固定配置为0。

返回值说明

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




aclrtCntNotifyRecord

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

产品支持情况

  • Ascend 950PR/Ascend 950DT：支持
  • Atlas A3 训练系列产品/Atlas A3 推理系列产品：不支持
  • Atlas A2 训练系列产品/Atlas A2 推理系列产品：不支持
  • Atlas 200I/500 A2 推理产品：不支持
  • Atlas 推理系列产品：不支持
  • Atlas 训练系列产品：不支持
  • IPV350：不支持

功能说明

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

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

参数说明

参数名 输入/输出 说明
cntNotify 输入 需记录的CntNotify。类型定义请参见aclrtCntNotify。
stream 输入 指定Stream。类型定义请参见aclrtStream。
如果使用默认Stream，此处设置为NULL。
多Stream同步等待场景下，例如，Stream2等Stream1的场景，此处配置为Stream1。
info 输入 控制Record的行为模式。类型定义请参见aclrtCntNotifyRecordInfo。

返回值说明

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




aclrtCntNotifyWaitWithTimeout

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

产品支持情况

  • Ascend 950PR/Ascend 950DT：支持
  • Atlas A3 训练系列产品/Atlas A3 推理系列产品：不支持
  • Atlas A2 训练系列产品/Atlas A2 推理系列产品：不支持
  • Atlas 200I/500 A2 推理产品：不支持
  • Atlas 推理系列产品：不支持
  • Atlas 训练系列产品：不支持
  • IPV350：不支持

功能说明

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

参数说明

参数名 输入/输出 说明
cntNotify 输入 需等待的CntNotify。类型定义请参见aclrtCntNotify。
stream 输入 指定Stream。类型定义请参见aclrtStream。
如果使用默认Stream，此处设置为NULL。
多Stream同步等待场景下，例如，Stream2等Stream1的场景，此处配置为Stream2。
info 输入 控制Wait的行为模式。类型定义请参见aclrtCntNotifyWaitInfo。

返回值说明

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




aclrtCntNotifyReset

aclError aclrtCntNotifyReset(aclrtCntNotify cntNotify, aclrtStream stream)

产品支持情况

  • Ascend 950PR/Ascend 950DT：支持
  • Atlas A3 训练系列产品/Atlas A3 推理系列产品：不支持
  • Atlas A2 训练系列产品/Atlas A2 推理系列产品：不支持
  • Atlas 200I/500 A2 推理产品：不支持
  • Atlas 推理系列产品：不支持
  • Atlas 训练系列产品：不支持
  • IPV350：不支持

功能说明

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

参数说明

参数名 输入/输出 说明
cntNotify 输入 CntNotify的指针。类型定义请参见aclrtCntNotify。
stream 输入 指定Stream。类型定义请参见aclrtStream。
如果使用默认Stream，此处设置为NULL。
多Stream同步等待场景下，例如，Stream2等Stream1的场景，此处配置为Stream2。

返回值说明

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




aclrtCntNotifyGetId

aclError aclrtCntNotifyGetId(aclrtCntNotify cntNotify, uint32_t *notifyId)

产品支持情况

  • Ascend 950PR/Ascend 950DT：支持
  • Atlas A3 训练系列产品/Atlas A3 推理系列产品：不支持
  • Atlas A2 训练系列产品/Atlas A2 推理系列产品：不支持
  • Atlas 200I/500 A2 推理产品：不支持
  • Atlas 推理系列产品：不支持
  • Atlas 训练系列产品：不支持
  • IPV350：不支持

功能说明

获取CntNotify的ID。

参数说明

参数名 输入/输出 说明
cntNotify 输入 cntNotify的指针。类型定义请参见aclrtCntNotify。
notifyId 输出 cntNotify ID。

返回值说明

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




aclrtCntNotifyDestroy

aclError aclrtCntNotifyDestroy(aclrtCntNotify cntNotify)

产品支持情况

  • Ascend 950PR/Ascend 950DT：支持
  • Atlas A3 训练系列产品/Atlas A3 推理系列产品：不支持
  • Atlas A2 训练系列产品/Atlas A2 推理系列产品：不支持
  • Atlas 200I/500 A2 推理产品：不支持
  • Atlas 推理系列产品：不支持
  • Atlas 训练系列产品：不支持
  • IPV350：不支持

功能说明

销毁CntNotify。

参数说明

参数名 输入/输出 说明
cntNotify 输入 CntNotify的指针。类型定义请参见aclrtCntNotify。

返回值说明

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