aclrtCreateEventExWithFlag

产品支持情况

功能说明

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

函数原型

aclError aclrtCreateEventExWithFlag(aclrtEvent *event, uint32_t flag)

参数说明

返回值说明

返回0表示成功，返回其他值表示失败，请参见aclError。

约束说明

• 采用本API创建的Event，不支持在以下接口中使用：aclrtResetEvent、aclrtQueryEvent、aclrtQueryEventWaitStatus。
• 调用本接口创建Event时，flag为bitmap，支持将flag设置为单个宏、或者对多个宏进行或操作。
  • 若flag参数值包含ACL_EVENT_SYNC宏，后续调用aclrtRecordEvent接口时，系统内部才会申请Event资源，因此会受Event数量的限制，Event达到上限后，系统内部会等待资源释放。

    不同型号的硬件支持的Event数量不同，如下表所示：

    型号	单个Device支持的Event最大数
    Atlas 推理系列产品 Atlas 200/300/500 推理产品	1023
    Atlas 训练系列产品	65535
    Atlas A3 训练系列产品/Atlas A3 推理系列产品 Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件 Atlas 200I/500 A2 推理产品	65536

  • 若flag参数值不包含ACL_EVENT_SYNC宏，则不支持在aclrtStreamWaitEvent接口中使用本接口创建的Event。