产品支持情况

产品	是否支持
Ascend 950PR / Ascend 950DT	√
Atlas A3 训练系列产品 / Atlas A3 推理系列产品	√
Atlas A2 训练系列产品 / Atlas A2 推理系列产品	√
Atlas 200I/500 A2 推理产品	√
Atlas 推理系列产品	√
Atlas 训练系列产品	√

功能说明

创建带flag的Event，不同flag的Event用于不同的功能。支持创建Event时携带多个flag（按位进行或操作），从而同时启用对应flag的功能。创建Event时，Event资源不受硬件限制。

函数原型

      
           aclError aclrtCreateEventExWithFlag(aclrtEvent *event, uint32_t flag)

参数说明

参数名	输入/输出	说明
event	输出	Event的指针。类型定义请参见aclrtEvent。
flag	输入	Event指针的flag。 flag为bitmap，支持将flag设置为单个宏、或者对多个宏进行或操作。当前支持将flag设置为如下宏： ACL_EVENT_TIME_LINE：使用该bit表示创建的Event需要记录时间戳信息。注意：使用时间戳功能会影响Event相关接口的性能。 ACL_EVENT_SYNC：使用该bit表示创建的Event支持多Stream间的同步。 ACL_EVENT_CAPTURE_STREAM_PROGRESS：使用该bit表示创建的Event用于跟踪stream的任务执行进度。 ACL_EVENT_IPC：使用该bit表示创建的Event用于进程间通信，详细说明请参见aclrtIpcGetEventHandle。注意： Ascend 950DT 上不支持使用本flag创建Event；本flag不支持与其他flag进行位或操作；本flag创建出来的Event不支持在以下接口或场景中使用：aclrtResetEvent、aclrtQueryEvent、aclrtQueryEventWaitStatus、aclrtEventElapsedTime、aclrtEventGetTimestamp、aclrtGetEventId、模型捕获场景（参见aclmdlRICaptureBegin中的说明），否则返回报错。宏的定义如下： #define ACL_EVENT_TIME_LINE 0x00000008U #define ACL_EVENT_SYNC 0x00000001U #define ACL_EVENT_CAPTURE_STREAM_PROGRESS 0x00000002U #define ACL_EVENT_IPC 0x00000040U

参数名

输入/输出

说明

event

输出

Event的指针。类型定义请参见aclrtEvent。

flag

输入

Event指针的flag。

flag为bitmap，支持将flag设置为单个宏、或者对多个宏进行或操作。

当前支持将flag设置为如下宏：

ACL_EVENT_TIME_LINE：使用该bit表示创建的Event需要记录时间戳信息。注意：使用时间戳功能会影响Event相关接口的性能。

ACL_EVENT_SYNC：使用该bit表示创建的Event支持多Stream间的同步。
ACL_EVENT_CAPTURE_STREAM_PROGRESS：使用该bit表示创建的Event用于跟踪stream的任务执行进度。
ACL_EVENT_IPC：使用该bit表示创建的Event用于进程间通信，详细说明请参见aclrtIpcGetEventHandle。注意： Ascend 950DT 上不支持使用本flag创建Event；本flag不支持与其他flag进行位或操作；本flag创建出来的Event不支持在以下接口或场景中使用：aclrtResetEvent、aclrtQueryEvent、aclrtQueryEventWaitStatus、aclrtEventElapsedTime、aclrtEventGetTimestamp、aclrtGetEventId、模型捕获场景（参见aclmdlRICaptureBegin中的说明），否则返回报错。

宏的定义如下：

#define ACL_EVENT_TIME_LINE 0x00000008U
#define ACL_EVENT_SYNC 0x00000001U
#define ACL_EVENT_CAPTURE_STREAM_PROGRESS 0x00000002U
#define ACL_EVENT_IPC 0x00000040U

返回值说明

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

约束说明

采用本API创建的Event，不支持在以下接口中使用：aclrtResetEvent、aclrtQueryEvent、aclrtQueryEventWaitStatus，否则返回报错。
若flag参数值不包含ACL_EVENT_SYNC宏，则不支持在aclrtStreamWaitEvent接口中使用本接口创建的Event。若flag参数值包含ACL_EVENT_SYNC宏，并不会实际申请Event资源，只有在调用aclrtRecordEvent接口时，才会进行资源申请，因此在调用aclrtRecordEvent时，可能会出现线程阻塞，等待Event资源的释放。

不同型号的硬件支持的Event数量不同：
- 对于以下产品型号，单个Device支持的Event最大数为65536：
  Ascend 950PR / Ascend 950DT
  
  Atlas A3 训练系列产品 / Atlas A3 推理系列产品
  
  Atlas A2 训练系列产品 / Atlas A2 推理系列产品
  
  Atlas 200I/500 A2 推理产品
- 对于 Atlas 推理系列产品，单个Device支持的Event最大数为1023：
- 对于 Atlas 训练系列产品，单个Device支持的Event最大数为65535。

接口调用示例

接口调用示例，参见Event的创建与销毁。