aclrtNotifyImportByKey

产品支持情况

产品 是否支持
Atlas A3 训练系列产品/Atlas A3 推理系列产品
Atlas A2 训练系列产品/Atlas A2 推理系列产品

功能说明

在本进程中获取key的信息,并返回本进程可以使用的Notify指针。

本接口需与其它接口配合使用,以便实现多Device上不同进程间的任务同步,请参见aclrtNotifyGetExportKey接口处的说明。

函数原型

aclError aclrtNotifyImportByKey(aclrtNotify *notify, const char *key, uint64_t flags)

参数说明

参数名 输入/输出 说明
notify 输出 Notify指针。
key 输入 Notify共享名称。
必须先调用aclrtNotifyGetExportKey接口获取指定Notify的共享名称,再作为入参传入。
flags 输入 是否开启两个Device之间的数据交互。
取值为如下宏:

- ACL_RT_NOTIFY_IMPORT_FLAG_DEFAULT:默认值,关闭两个Device之间的数据交互。配置为该值时,需单独调用aclrtDeviceEnablePeerAccess接口开启两个Device之间的数据交互。
- ACL_RT_NOTIFY_IMPORT_FLAG_ENABLE_PEER_ACCESS:开启两个Device之间的数据交互。配置为该值时,则无需调用aclrtDeviceEnablePeerAccess接口。


宏的定义如下:
#define ACL_RT_NOTIFY_IMPORT_FLAG_DEFAULT 0x0UL
#define ACL_RT_NOTIFY_IMPORT_FLAG_ENABLE_PEER_ACCESS 0x02UL

返回值说明

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

约束说明

昇腾虚拟化实例场景不支持该操作。