aclrtCreateEvent

函数功能

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

约束说明

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

Event数量限制如下：

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

Atlas 推理系列产品（Ascend 310P处理器），单个Device上最多支持1023个Event。

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

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

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

函数原型

aclError aclrtCreateEvent(aclrtEvent *event)

参数说明

返回值说明

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

相关接口

您也可以使用aclrtCreateEventWithFlag或aclrtCreateEventExWithFlag接口创建一个带标识的Event，不同标识的Event用于不同的功能。

参考资源

接口调用流程及调用示例，参见Event的同步等待示例代码、Stream间任务的同步等待接口调用流程及示例代码。