aclrtNotifyImportByKey

产品	是否支持
Atlas A3 训练系列产品/Atlas A3 推理系列产品	√
Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件	√
Atlas 200I/500 A2 推理产品	x
Atlas 推理系列产品	√
Atlas 训练系列产品	x

在本进程中获取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

参数名

输入/输出

说明

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。

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

父主题： Notify管理