跳到主要内容

aclrtQueryEvent

aclrtRecordEvent​

函数功能​

在Stream中记录一个Event。

约束说明​

  • 该接口是异步接口，调用接口成功仅表示任务下发成功，不表示任务执行成功。调用该接口后，需调用同步等待接口（例如，aclrtSynchronizeStream）确保任务已执行完成。

  • aclrtRecordEvent接口与aclrtStreamWaitEvent接口配合使用时，主要用于多Stream之间同步的场景，在调用aclrtRecordEvent接口时，系统内部会申请Event资源，在调用aclrtStreamWaitEvent接口之后，请及时调用aclrtResetEvent接口释放Event资源。

    接口调用顺序：aclrtCreateEvent-->aclrtRecordEvent-->aclrtStreamWaitEvent-->aclrtResetEvent

  • 由于在调用aclrtRecordEvent接口，系统内部会申请Event资源，因此会受Event数量的限制，具体如下：

    Atlas 200/500 A2推理产品，单个Device上最多支持65535个Event。

函数原型​

aclError aclrtRecordEvent(aclrtEvent event, aclrtStream stream)

参数说明​

参数名输入/输出说明
event输入待记录的Event。
stream输入将指定Event记录在指定的Stream中。 如果使用默认Stream，此处设置为NULL。

返回值说明​

返回0表示成功，返回其它值表示失败。

参考资源​

父主题： 同步等待

aclrtResetEvent​

函数功能​

复位一个Event。用户需确保等待Stream中的任务都完成后，再复位Event，异步接口。

约束说明​

在复位Event时，涉及重置Event的状态，Event的状态是在调用aclrtRecordEvent接口时记录，因此在调用aclrtResetEvent接口前，需要先调用aclrtRecordEvent接口。

接口调用顺序：aclrtCreateEvent-->aclrtRecordEvent-->aclrtResetEvent-->aclrtSynchronizeStream

函数原型​

aclError aclrtResetEvent(aclrtEvent event, aclrtStream stream)

参数说明​

参数名输入/输出说明
event输入待复位的Event。
stream输入指定Event所在的Stream。

返回值说明​

返回0表示成功，返回其它值表示失败。

父主题： 同步等待

aclrtQueryEvent​

备注

须知

此接口后续版本会废弃，请使用aclrtQueryEventStatus接口。

函数功能​

查询与本接口在同一线程中的aclrtRecordEvent接口所记录的Event是否执行完成。同步接口。

函数原型​

aclError aclrtQueryEvent(aclrtEvent event, aclrtEventStatus *status)

参数说明​

参数名输入/输出说明
event输入指定待查询的Event。
status输出Event状态的指针。

返回值说明​

返回0表示成功，返回其它值表示失败。

父主题： 同步等待

aclrtQueryEventStatus​

函数功能​

本接口是aclrtQueryEvent接口的扩展接口，可查询与本接口在同一线程或不同线程中的aclrtRecordEvent接口所记录的Event是否执行完成。同步接口。

函数原型​

aclError aclrtQueryEventStatus(****aclrtEvent event, aclrtEventRecordedStatus *status)

参数说明​

参数名输入/输出说明
event输入指定待查询的Event。
status输出Event状态的指针。

返回值说明​

返回0表示成功，返回其它值表示失败。

父主题： 同步等待

aclrtQueryEventWaitStatus​

函数功能​

调用aclrtStreamWaitEvent接口后，查询Stream是否接收到指定Event。如果多个Stream等待同一个Event，则多个Stream都接收到Event，通过该接口查询的Event状态才是已完成。同步接口。

函数原型​

aclError aclrtQueryEventWaitStatus(****aclrtEvent event, aclrtEventWaitStatus *status)

参数说明​

参数名输入/输出说明
event输入指定待查询的Event。
status输出Event状态的指针。

返回值说明​

返回0表示成功，返回其它值表示失败。

父主题： 同步等待

aclrtSynchronizeEvent​

函数功能​

阻塞应用程序运行，等待Event完成，同步接口。

函数原型​

aclError aclrtSynchronizeEvent(aclrtEvent event)

参数说明​

参数名输入/输出说明
event输入需等待的Event。

返回值说明​

返回0表示成功，返回其它值表示失败。

参考资源​

接口调用示例，参见Event的同步等待示例代码。

父主题： 同步等待

在线提单