函数：create_event_with_flag

aclError aclrtCreateEventWithFlag(aclrtEvent *event, uint32_t flag)

event, ret = acl.rt.create_event_with_flag(flag)

创建一个带flag的Event，不同flag的Event用于不同的功能。支持创建Event时携带多个flag（按位进行或操作），从而同时使能对应flag的功能。

flag：int，Event的flag，可支持以下选项。

• ACL_EVENT_TIME_LINE = 0x00000008，表示创建的Event数量不受限制且创建出来的Event可用于统计两个Event之间的耗时。
• ACL_EVENT_SYNC = 0x00000001，表示创建的Event数量受限且创建出来的可用于多Stream间的同步等待。
• ACL_EVENT_CAPTURE_STREAM_PROGRESS = 0x00000002，表示创建的Event用于跟踪Stream的任务执行进度。

event：int，创建的Event对象指针地址。

ret：int，错误码。

• 返回0表示成功。
• 返回其它值表示失败。

使用本接口创建Event时，“flag”为bitmap，支持对单个flag或者多个flag进行操作，例如：acl.rt.create_event_with_flag( ACL_EVENT_TIME_LINE | ACL_EVENT_SYNC )。

• 若“flag”参数值包含“ACL_EVENT_SYNC”，则创建出来的Event数量受限，具体参考如下：

  Atlas 200/300/500 推理产品，单个Device上最多支持1023个Event。

  Atlas 200I/500 A2推理产品，单个Device上最多支持1023个Event。

  Atlas 训练系列产品，单个Device上最多支持65535个Event。

  Atlas A2训练系列产品，单个Device上最多支持65535个Event。

• 若flag参数值不包含“ACL_EVENT_SYNC”，则不支持在以下API中使用本接口创建的Event：acl.rt.reset_event、acl.rt.stream_wait_event、acl.rt.query_event_wait_status。

您也可以使用acl.rt.create_event接口创建Event，Event数量有限，创建出来的Event可用于统计两个Event之间的耗时、多Stream场景下的同步等待、Event内的同步等待等场景。

• 接口调用流程，参见多Stream接口调用流程。
• 接口调用示例，参见关于Event的同步等待、关于Stream间任务的同步等待。