Function: create_event

Applicable Products

Product	Supported (√/x)
Ascend 950PR/Ascend 950DT	√
Atlas A3 training products/Atlas A3 inference products	√
Atlas A2 training products/Atlas A2 inference products	√
Atlas training products	√
Atlas inference products	√
Atlas 200I/500 A2 inference products	√

Description

Creates an event, which can be used to compute the elapsed time between two events and synchronize streams.

Prototype

C Prototype

aclError aclrtCreateEvent(aclrtEvent *event)

Python Function
1
event, ret = acl.rt.create_event()

Parameters

None

Return Values

Return Value	Description
event	Int, pointer address of the created event object.
ret	Int, error code. 0 on success; else, failure.

Restrictions

The event created using this API cannot be used in the acl.rt.reset_event API. Otherwise, undefined behavior may occur.

After an event is created by calling this API, the system allocates event resources only when acl.rt.record_event is called. Therefore, the number of events is limited. After the number of events reaches the upper limit, the system waits for resource release.

Limit on the number of events:

For the Atlas inference products, a single device supports a maximum of 1,023 events.

For the Atlas 200I/500 A2 inference products, a single device supports a maximum of 65,536 events.

For the Atlas training products, a single device supports a maximum of 65,535 events.

For the Atlas A2 training products/Atlas A2 inference products, a single device supports a maximum of 65,536 events.

For the Atlas A3 training products/Atlas A3 inference products, a single device supports a maximum of 65,536 events.

Parent topic: Event Management