aclrtQueryEventStatus

Applicability

Product	Supported
Atlas 350 Accelerator Card	√
Atlas A3 training product/Atlas A3 inference product	√
Atlas A2 training product/Atlas A2 inference product	√
Atlas 200I/500 A2 inference product	√
Atlas inference product	√
Atlas training product	√

Description

Queries the execution status of all tasks captured in an event. For more details, see aclrtRecordEvent.

Prototype

aclError aclrtQueryEventStatus(aclrtEvent event, aclrtEventRecordedStatus *status)

Parameters

Parameter	Input/Output	Description
event	Input	Event to query. For details about the type definition, see aclrtEvent.
status	Output	Pointer to the event status. For details about the type definition, see aclrtEventRecordedStatus. If all tasks captured in the event are completed, ACL_EVENT_RECORDED_STATUS_COMPLETE is returned. If any task is not completed, ACL_EVENT_RECORDED_STATUS_NOT_READY is returned.

Parameter

Input/Output

Description

event

Input

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

status

Output

Pointer to the event status. For details about the type definition, see aclrtEventRecordedStatus.

If all tasks captured in the event are completed, ACL_EVENT_RECORDED_STATUS_COMPLETE is returned. If any task is not completed, ACL_EVENT_RECORDED_STATUS_NOT_READY is returned.

Returns

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

Restrictions

If aclrtRecordEvent and aclrtQueryEventStatus are called on different threads, the execution time of the two APIs may be out of order. As a result, the completion status of the queried event object does not meet the expectation.

Parent topic: Event Management