Function: create_event_with_flag

aclError aclrtCreateEventWithFlag(aclrtEvent *event, uint32_t flag)

event, ret = acl.rt.create_event_with_flag(flag)

Creates an event with a flag. Events with different flags are used for different functions. When an event is created, multiple flags can be carried (bitwise OR operation) to enable the corresponding flag function.

flag: int, event flag. The options are as follows:

• ACL_EVENT_TIME_LINE = 0x00000008 indicates that the number of created events is not limited, and the created events can be used to compute the elapsed time between events.
• ACL_EVENT_SYNC = 0x00000001 indicates that the number of created events is limited, and the created events can be used for synchronization between multiple streams.
• ACL_EVENT_CAPTURE_STREAM_PROGRESS = 0x00000002 indicates that the created event is used to trace the task execution progress of the stream.

event: int, pointer address of the created event object.

ret: int, error code.

• 0 indicates success.
• Other values indicate failure.

When this API is called to create an event, flag is a bitmap. Operations can be performed on a single flag or multiple flags, for example, acl.rt.create_event_with_flag( ACL_EVENT_TIME_LINE | ACL_EVENT_SYNC).

• If the flag contains the ACL_EVENT_SYNC, the number of created events is limited. For details, see the following:

  For the Atlas 200/300/500 Inference Product, a single device supports a maximum of 1023 events.

  For the Atlas Training Series Product, a single device supports a maximum of 65535 events.

• If the value of flag does not contain ACL_EVENT_SYNC, events created using this API cannot be used in the following APIs: acl.rt.reset_event, acl.rt.stream_wait_event, and acl.rt.query_event_wait_status.