函数：launch_callback

产品支持情况

产品	是否支持
Atlas A3 训练系列产品/Atlas A3 推理系列产品	√
Atlas A2 训练系列产品/Atlas 800I A2 推理产品/A200I A2 Box 异构组件	√
Atlas 训练系列产品	√
Atlas 推理系列产品	√
Atlas 200I/500 A2 推理产品	√
Atlas 200/300/500 推理产品	√

使用说明

C函数原型	aclError *aclrtLaunchCallback(aclrtCallback fn, void userData, aclrtCallbackBlockType blockType, aclrtStream stream)**
Python函数	ret = acl.rt.launch_callback(fn, user_data_list, block_type, stream)
函数功能	异步任务场景下，在Stream的任务队列中下发一个函数回调任务，系统内部在执行到该回调任务时，会在Stream上订阅的线程（通过acl.rt.subscribe_report接口注册的线程）中执行回调函数。异步接口。本接口需与以下其它接口配合使用，以便实现异步场景下的Callback功能：新建线程，在线程函数内，调用acl.rt.process_report接口设置超时时间（需循环调用），等待acl.rt.launch_callback接口下发的函数回调任务。调用acl.rt.subscribe_report接口建立第1步中的线程和Stream的绑定关系，该Stream下发的函数回调任务将在绑定的线程中执行。在指定Stream上执行异步任务（例如异步推理任务）。定义并实现回调函数，调用acl.rt.launch_callback接口在Stream的任务队列中下发函数回调任务，触发acl.rt.subscribe_report订阅的线程处理回调函数，每调用一次acl.rt.launch_callback接口，就会下发一个回调函数任务。异步任务全部执行完成后，调用acl.rt.unsubscribe_report接口取消线程订阅，解除线程和Stream的绑定关系。
输入说明	fn：function，表示Python侧的回调函数。 user_data_list：list，表示需要传递给回调函数的参数（目前传入的是list类型的数据）。 block_type：int，指定回调任务是否阻塞本Stream上后续任务的执行。 0：表示非阻塞。 Atlas 200/300/500 推理产品，当前版本不支持该选项，该选项预留。 1：表示阻塞。 stream：int，表示指定的Stream。
返回值说明	ret：int，错误码。返回0表示成功。返回其它值表示失败。
约束说明	该接口是异步接口，调用接口成功仅表示任务下发成功，不表示任务执行成功。调用该接口后，需调用同步等待接口（例如，acl.rt.synchronize_stream）确保任务已执行完成。
参考资源	接口调用流程，参见接口调用流程。接口调用示例，参见示例代码。

父主题： 执行控制