Esa_Interface_Callback_Register()
摘要
注册一个回调,当模型代码为指定接口赋值时该回调被调用。
语法
Esa_Interface_Callback_Register (esa_state_ptr, status_ptr, interface, proc, array_proc, state_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
esa_state_ptr |
EsaT_State_Handle |
由 Esa_Init() 生成的 ESA 状态信息。 |
status_ptr |
int * |
指示错误原因的状态值(当返回值为 EsaC_Comp_Failure 时);取表 2 外部仿真访问包符号常量中的值之一。 |
interface |
EsaT_Interface |
感兴趣的接口 |
proc |
EsaT_Interface_Callback_Proc |
当指定接口以非数组形式被赋值时调用的函数。 |
array_proc |
EsaT_Interface_Array_Callback_Proc |
当指定接口作为数组的一部分被赋值时调用的函数。 |
state_ptr |
void * |
调用 proc 和 array_proc 函数时传递给它们的客户端数据。 |
返回类型
EsaT_Compcode
注册成功返回 EsaC_Comp_Success;否则返回 EsaC_Comp_Failure。
头文件
esa.h
详情
模型代码使用 op_esys_interface_value_set()、op_esys_interface_array_set() 或 op_esys_interface_vector_set() 设置接口值。如果已为该接口注册了回调,则一旦使用这些内核过程之一设置该值,其中一个回调就会被调用,使外部代码能够立即处理该信息。如果没有注册任何回调,则接口值必须由联合仿真代码在 Esa_Execute_Until() 返回后轮询获取。
有两种可能的回调:
- 如果接口通过
op_esys_interface_value_set()单独赋值,则调用proc回调。proc函数原型见EsaT_Interface_Callback_Proc。 - 如果接口通过
op_esys_interface_array_set()或op_esys_interface_vector_set()作为数组的一部分赋值,则调用array_proc回调。array_proc函数原型见EsaT_Interface_Array_Callback_Proc。