aclrtResetEvent

Applicable Products

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

Function

Resets an event to its initial state so that the event can be reused. This is an asynchronous API.

For stream synchronization, this API is called after an aclrtStreamWaitEvent call.

Prototype

aclError aclrtResetEvent(aclrtEvent event, aclrtStream stream)

Parameters

Parameter	Input/Output	Description
event	Input	Event to reset. For details about the type definition, see aclrtEvent.
stream	Input	Stream. For details about the type definition, see aclrtStream. For stream synchronization, for example, Stream2 waits for Stream1, set this parameter to Stream2.

Parameter

Input/Output

Description

event

Input

Event to reset. For details about the type definition, see aclrtEvent.

stream

Input

Stream. For details about the type definition, see aclrtStream.

For stream synchronization, for example, Stream2 waits for Stream1, set this parameter to Stream2.

Returns

0 on success; otherwise, failure. For details, see aclError.

Restrictions

Only the events created by the aclrtCreateEventWithFlag API and flagged with ACL_EVENT_SYNC can be reset.

Note: If tasks in multiple streams need to wait for the same event, calling this API to reset the event is not recommended. As shown in the figure, if the aclrtResetEvent API is called after the aclrtStreamWaitEvent API in Stream2, the event will be reset. As a result, the aclrtStreamWaitEvent API in Stream3 will fail.

Parent topic: Event Management