函数：create_event

aclError aclrtCreateEvent(aclrtEvent *event)

event, ret = acl.rt.create_event()

创建一个Event，创建的Event可用于统计两个Event之间的耗时、多Stream场景下的同步等待等场景。

无

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

ret：int，错误码。

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

调用本接口创建Event后，后续调用acl.rt.record_event接口时，系统内部才会申请Event资源，因此会受Event数量的限制，Event达到上限后，系统内部会等待资源释放。

Event数量限制如下：

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

Atlas 推理系列产品，单个Device上最多支持1023个Event。

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

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

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

您也可以使用acl.rt.create_event_with_flag接口创建一个带标识的Event，不同标识的Event用于不同的功能。

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