函数：get_stream_id_from_exception_info
函数：set_exception_info_callback
| C函数原型 | aclError aclrtSetExceptionInfoCallback(aclrtExceptionInfoCallback callback) |
|---|---|
| Python函数 | ret = acl.rt.set_exception_info_callback(fn) |
| 函数功能 | 设置异常回调函数，同步接口。 |
| 输入说明 | fn：function，表示Python侧的回调函数，格式如下： python<br>def exception_callback(exception_info)<br>"""<br>:exception_info: 表示异常信息aclrtExceptionInfo的指针地址<br>:return:<br>"""<br> |
| 返回值说明 | ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败。 |
| 约束说明 | - 您需要在执行异步任务之前，设置异常回调函数，当Device上的任务执行异常时，系统会向用户设置的异常回调函数中传入一个包含任务ID、Stream ID、线程ID、Device ID以及错误码的aclrtExceptionInfo的指针地址，并执行回调函数，用户可以再分别调用acl.rt.get_task_id_from_exception_info、acl.rt.get_stream_id_from_exception_info、acl.rt.get_thread_id_from_exception_info、acl.rt.get_device_id_from_exception_info、acl.rt.get_error_code_from_exception_info接口获取产生异常的任务ID、Stream ID、线程ID、Device ID以及错误码，便于定位问题。 使用场景****举例：例如，在调用acl.op.execute_v2接口前，调用acl.rt.set_exception_info_callback接口设置异常回调函数，当算子在Device执行异常时，系统会向用户设置的异常回调函数中传入一个包含任务ID、Stream ID、线程ID、Device ID以及错误码的aclrtExceptionInfo的指针地址，并执行回调函数。 - 如果多次设置异常回调函数，以最后一次设置为准。 - 如果想清空回调函数，可再次调用acl.rt.set_exception_info_callback接口进行重置（传入None或不传入参数）。 |
| 参考资源 | 接口调用示例，参见AI Core异常信息获取。 |
父主题： 同步等待
函数：get_task_id_from_exception_info
| C函数原型 | uint32_t aclrtGetTaskIdFromExceptionInfo(const aclrtExceptionInfo *info) |
|---|---|
| Python函数 | task_id = acl.rt.get_task_id_from_exception_info(info) |
| 函数功能 | 获取异常信息中的任务ID，同步接口。该接口与acl.rt.set_exception_info_callback接口配合使用。 |
| 输入说明 | info：int，表示异常信息aclrtExceptionInfo的指针地址。 在执行任务之前调用acl.rt.set_exception_info_callback接口，系统会将产生异常的任务ID、Stream ID、线程ID、Device ID存放在aclExceptionInfo中。 |
| 返回值说明 | task_id：int，返回异常信息中的任务ID，返回值为“0xFFFFFFFF”（以十六进制为例）时表示异常信息为空。 |
| 约束说明 | 无 |
| 参考资源 | 接口调用示例，参见AI Core异常信息获取。 |
父主题： 同步等待
函数：get_stream_id_from_exception_info
| C函数原型 | uint32_t aclrtGetStreamIdFromExceptionInfo(const aclrtExceptionInfo *info) |
|---|---|
| Python函数 | stream_id = acl.rt.get_stream_id_from_exception_info(info) |
| 函数功能 | 获取异常信息中的Stream ID，同步接口。该接口与acl.rt.set_exception_info_callback接口配合使用。 |
| 输入说明 | info：int，表示异常信息aclrtExceptionInfo的指针地址。 在执行任务之前调用acl.rt.set_exception_info_callback接口，系统会将产生异常的任务ID、Stream ID、线程ID、Device ID存放在aclExceptionInfo中。 |
| 返回值说明 | stream_id：int，返回异常信息中的Stream ID，返回值为“0xFFFFFFFF”（以十六进制为例）时表示异常信息为空。 |
| 约束说明 | 无 |
| 参考资源 | 接口调用示例，参见AI Core异常信息获取。 |
父主题： 同步等待
函数：get_thread_id_from_exception_info
| C函数原型 | uint32_t aclrtGetThreadIdFromExceptionInfo(const aclrtExceptionInfo *info) |
|---|---|
| Python函数 | thread_id = acl.rt.get_thread_id_from_exception_info(info) |
| 函数功能 | 获取异常信息中的线程ID，同步接口。该接口与acl.rt.set_exception_info_callback接口配合使用。 |
| 输入说明 | info：int，表示异常信息aclrtExceptionInfo的指针地址。 在执行任务之前调用acl.rt.set_exception_info_callback接口，系统会将产生异常的任务ID、Stream ID、线程ID、Device ID存放在aclExceptionInfo中。 |
| 返回值说明 | thread_id：int，返回异常信息中的线程ID，返回值为“0xFFFFFFFF”（以十六进制为例）时表示异常信息为空。 |
| 约束说明 | 无 |
父主题： 同步等待
函数：get_device_id_from_exception_info
| C函数原型 | uint32_t aclrtGetDeviceIdFromExceptionInfo(const aclrtExceptionInfo *info) |
|---|---|
| Python函数 | device_id = acl.rt.get_device_id_from_exception_info(info) |
| 函数功能 | 获取异常信息中的Device ID，同步接口。 |
| 输入说明 | info：int，表示异常信息aclrtExceptionInfo的指针地址。 在执行任务之前调用acl.rt.set_exception_info_callback接口，系统会将产生异常的任务ID、Stream ID、线程ID、Device ID存放在aclExceptionInfo中。 |
| 返回值说明 | device_id：int，返回异常信息中的Device ID，返回值为“0xFFFFFFFF”（以十六进制为例）时表示异常信息为空。 |
| 约束说明 | 无 |
| 参考资源 | 接口调用示例，参见AI Core异常信息获取。 |
父主题： 同步等待
函数：get_error_code_from_exception_info
| C函数原型 | uint32_t aclrtGetErrorCodeFromExceptionInfo(const aclrtExceptionInfo *info) |
|---|---|
| Python函数 | ret = acl.rt.get_error_code_from_exception_info**(info)** |
| 函数功能 | 获取异常信息中的错误码，同步接口。该接口与acl.rt.set_exception_info_callback接口配合使用。 |
| 输入说明 | info：int，异常信息aclrtExceptionInfo的指针地址。 在执行任务之前调用acl.rt.set_exception_info_callback接口，系统会将产生异常的任务ID、Stream ID、线程ID、Device ID、错误码存放在aclExceptionInfo中。 |
| 返回值说明 | ret：int，错误码。 - 返回0表示成功。 - 返回其它值表示失败,返回值为“0xFFFFFFFF”（以十六进制为例）时表示Device异常。 |
| 约束说明 | 无 |
父主题： 同步等待
在线提单