Esa_Interface_Value_Set()
摘要
设置接口的值。
语法
Esa_Interface_Value_Set (esa_state_ptr, status_ptr, interface, schedule_time, …)
| 参数 | 类型 | 说明 |
|---|---|---|
esa_state_ptr |
EsaT_State_Handle |
由 Esa_Init() 生成的 ESA 状态信息 |
status_ptr |
int * |
指示错误原因的状态值(当返回值为 EsaC_Comp_Failure 时);取表 2 外部仿真访问包符号常量中的值之一。 |
interface |
EsaT_Interface |
感兴趣接口的标识符 |
schedule_time |
double |
向接口所在 esys 模块上的进程模型投递 ESYS 中断的仿真时刻。 若设为 ESAC_NOTIFY_IMMEDIATELY,将强制中断所涉进程模型。若设为 ESAC_NOTIFY_NEVER,接口值会被设置,但不会向仿真投递任何通知。 |
... |
要设置给接口的值(取决于接口类型) |
返回类型
EsaT_Compcode
赋值成功返回 EsaC_Comp_Success;否则返回 EsaC_Comp_Failure(此时 *status_ptr 中包含指示失败来源的值)。
头文件
esa.h
详情
该函数用指定的新值覆盖接口的值。除非 schedule_time 为特殊值 ESAC_NOTIFY_NEVER,否则会向包含所涉接口的 esys 模块上的进程模型投递一个中断。
如果提供了有效的时间(假定该时间大于或等于当前仿真时间),中断将是计划中断;如果 schedule_time 设为 ESAC_NOTIFY_IMMEDIATELY,中断将是强制中断。
如果当前仿真时间位于最近执行事件的时刻(T1)与下一个计划事件的将来时刻(T2)之间,应以介于 T1 与 T2 之间的合适值调用 Esa_Current_Event_Time_Set(),使模型代码中对 op_sim_time() 的调用返回有效值(否则 op_sim_time() 将返回 T1)。