aclrtIpcGetEventHandle

产品支持情况

功能说明

将本进程中的指定Event设置为IPC（Inter-Process Communication） Event，并返回其handle（即Event句柄），用于在跨进程场景下实现任务同步，支持同一个Device内的多个进程以及跨Device的多个进程。

本接口需与以下其它关键接口配合使用，此处以A进程、B进程为例：

1. A进程中：
   1. 调用aclrtCreateEventExWithFlag接口创建flag为ACL_EVENT_IPC的Event。
   2. 调用aclrtIpcGetEventHandle接口获取用于进程间通信的Event句柄。
   3. 调用aclrtRecordEvent接口在Stream中插入1.a中创建的Event。
2. B进程中：
   1. 调用aclrtIpcOpenEventHandle接口获取A进程中的Event句柄信息，并返回本进程可以使用的Event指针。
   2. 调用aclrtStreamWaitEvent接口阻塞指定Stream的运行，直到指定的Event完成。
   3. Event使用完成后，调用aclrtDestroyEvent接口销毁Event。

函数原型

aclError aclrtIpcGetEventHandle(aclrtEvent event, aclrtIpcEventHandle *handle)

参数说明

返回值说明

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