aclrtCreateEvent
产品支持情况
|
产品 |
是否支持 |
|---|---|
|
|
√ |
|
|
√ |
|
|
√ |
|
|
√ |
|
|
√ |
|
|
√ |
功能说明
创建一个Event，创建出来的Event可用于统计两个Event之间的耗时、多Stream场景下的同步等待等场景。
函数原型
aclError aclrtCreateEvent(aclrtEvent *event)
参数说明
|
参数名 |
输入/输出 |
说明 |
|---|---|---|
|
event |
输出 |
Event的指针。 |
返回值说明
返回0表示成功，返回其他值表示失败，请参见aclError。
约束说明
调用本接口创建Event后，后续调用aclrtRecordEvent接口时，系统内部才会申请Event资源，因此会受Event数量的限制，Event达到上限后，系统内部会等待资源释放。
不同型号的硬件支持的Event数量不同，如下表所示：
|
型号 |
单个Device支持的Event最大数 |
|---|---|
|
|
1023 |
|
|
65535 |
|
|
65536 |
参考资源
- 接口调用流程及调用示例，参见Event的同步等待示例代码、Stream间任务的同步等待接口调用流程及示例代码。
- 您也可以使用aclrtCreateEventWithFlag或aclrtCreateEventExWithFlag接口创建一个带标识的Event，不同标识的Event用于不同的功能。