昇腾社区首页
中文
注册

函数:synchronize_event_with_timeout

产品支持情况

产品

是否支持

Atlas A3 训练系列产品 / Atlas A3 推理系列产品

Atlas A2 训练系列产品 / Atlas 800I A2 推理产品 /A200I A2 Box 异构组件

Atlas 训练系列产品

Atlas 推理系列产品

Atlas 200I/500 A2 推理产品

Atlas 200/300/500 推理产品

功能说明

阻塞当前线程运行直到Event捕获的所有任务都执行完成(具体见acl.rt.record_event接口参考Event捕获的细节)。

该接口在acl.rt.synchronize_event接口的基础上进行了增强,支持用户设置永久等待或配置具体的超时时间,若配置具体的超时时间,则当应用程序异常时可根据所设置的超时时间自行退出。

函数原型

  • C函数原型
    1
    aclError aclrtSynchronizeEventWithTimeout(aclrtEvent event, int32_t timeout)
    
  • python函数
    1
    ret = acl.rt.synchronize_event_with_timeout(event, timeout)
    

参数说明

参数名

说明

event

int,指定需等待的Event对象的指针地址。

timeout

int,接口的超时时间。

取值说明如下:

  • -1:表示永久等待与接口acl.rt.synchronize_event功能一致。
  • >0:配置具体的超时时间,单位是毫秒。

返回值说明

返回值

说明

ret

int,错误码,返回0表示成功,返回其它值表示失败。

约束说明

Atlas 200/300/500 推理产品 ,不支持调用接口配置具体的超时时间,仅支持设置永久等待。

资源参考

接口调用示例,参见关于Event的同步等待