Esa_Interface_Array_Set()
摘要
将接口值设置为一个数据数组。
语法
Esa_Interface_Array_Set (esa_state_ptr, status_ptr, interface, schedule_time, value, start_offset)
| 参数 | 类型 | 说明 |
|---|---|---|
esa_state_ptr |
EsaT_State_Handle |
由 Esa_Init() 生成的 ESA 状态信息 |
status_ptr |
int * |
若返回值为 EsaC_Comp_Failure,则其被设置为 ESAC_STATUS_INTERFACE_INVALID 或 ESAC_STATUS_DIRECTION_INVALID |
interface |
EsaT_Interface |
要设置的接口 |
schedule_time |
double |
向接口所在 esys 模块上的进程模型投递 ESYS 中断的仿真时间 若设置为 ESAC_NOTIFY_IMMEDIATELY,将强制中断相关进程模型。若设置为 ESAC_NOTIFY_NEVER,接口值被设置,但不向仿真投递通知。 |
value |
void * |
值数组的起始位置(类型取决于接口) |
start_offset |
int |
数组中的起始偏移 |
返回类型
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)。