---
title: 函数：create_event
description: "| 产品 | 是否支持 |"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/runtimeapi/aclpythondevg_01_0090.html
sourcePath: /source/zh/canncommercial/900/API/runtimeapi/aclpythondevg_01_0090.html
indexId: 4a7385f92e885be87e517a330530955c0f90809c88fd8bca5da4946383bb937071
---
# 函数：create_event

#### 产品支持情况

| 产品 | 是否支持 |
| --- | --- |
| Atlas 350 加速卡 | √ |
| Atlas A3 训练系列产品 / Atlas A3 推理系列产品 | √ |
| Atlas A2 训练系列产品 / Atlas A2 推理系列产品 | √ |
| Atlas 训练系列产品 | √ |
| Atlas 推理系列产品 | √ |
| Atlas 200I/500 A2 推理产品 | √ |


#### 功能说明

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


#### 函数原型

- C函数原型
  1 aclError aclrtCreateEvent(aclrtEvent *event)

- python函数
  1 event, ret = acl.rt.create_event()


#### 参数说明

无


#### 返回值说明

| 返回值 | 说明 |
| --- | --- |
| event | int，创建的Event对象的指针地址。 |
| ret | int，错误码，返回0表示成功，返回其它值表示失败。 |


#### 约束说明

采用本API创建的Event不支持在acl.rt.reset_event接口中使用，否则会导致未定义的行为。

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

Event数量限制如下：

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

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

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

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

Atlas A3 训练系列产品 / Atlas A3 推理系列产品 ，单个Device上最多支持65536个Event。