op_intrpt_schedule_call()
摘要
在指定的时间安排对指定过程的调用。
语法
op_intrpt_schedule_call (time, code, procedure, state_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
time |
double |
中断的安排时间 [该值应为绝对仿真时间,或来自表 58 “Interrupt Time Symbolic Constants“ 第 15 页的常量。] [如果“sim_time_quantum“首选项的值不为 0.0,绝对时间将在内部被截断为指定量子(quantum)的整数倍。] |
code |
int |
传递给被调用过程的用户定义数字代码 [该值是任意的、用户定义的整数,可用作所安排调用的识别代码。你可以为其指定一个文本字符串,当该代码出现在 ODB 事件横幅和跟踪中时,会连同该代码一起打印。有关详情,参见“Interrupt Code Map“ 第 507 页。] |
procedure |
Procedure |
所安排事件将要调用的过程 [该值必须是指向 C 函数的指针,该函数接受两个参数(下文讨论的状态内存指针和上文讨论的整数代码),并执行所需的仿真任务。] |
state_ptr |
void* |
指向传递给被调用过程的数据结构(或简单变量)的指针 |
返回类型
Evhandle
所安排中断的事件句柄。
[该返回值可以存储在状态变量中,以便在后续调用 op_ev_cancel() 时用于识别该中断。]
示例
/* function block procedures */
static void
c3sim_pos_animate (void * v_state_ptr, int code)
{
struct Pos_DS *ndp_ds_ptr = (struct Pos_DS *) v_state_ptr;
FIN (c3sim_pos_animate);
gfx_package_node_plot (ndp_ds_ptr->lat, ndp_ds_ptr->long, ndp_ds_ptr->alt);
FOUT;
}
void
c3sim_sched_pos_animation (int ntimes, double sim_duration)
{
double d, anim_int;
static struct Pos_DS node_ps_ds = {0, 0, 0};
FIN (c3sim_sched_pos_animation);
anim_int = sim_duration / ntimes;
for (d = 0.0; d < sim_duration; d += anim_int)
op_intrpt_schedule_call (d, 0, c3sim_pos_animate, &node_pos_ds);
FOUT;
}
详情
调用该内核过程会在仿真事件列表上放置一个新事件;这个新事件表示一个安排在指定时间执行的过程中断。事件一经安排,该内核过程就把控制权返回给调用进程。调用进程可以自由地进行任何活动。当所有较早的事件都已执行完毕,且过程中断事件位于仿真事件列表的头部时,其仿真时间被确立为当前仿真时间,事件随即执行。事件的执行会导致指定的过程被调用。被调用的过程会收到指定的状态指针和数字代码作为参数。
注意: 如果“sim_time_quantum“首选项的值不为 0.0,时间 将在内部被截断为指定量子(quantum)的整数倍。
将常量 OPC_INTRPT_SCHED_CALL_ENDSIM 用作 时间 参数,会使该过程被安排在仿真结束时执行。在这种情况下,过程中断会在任何 endsim 中断之前传送,但该过程安排的任何中断都不会被传送。优先级的处理方式与常规过程中断相同。
当过程中断表示某项可选活动时,可能由于条件变化而需要取消它。取消中断要求把该内核过程返回的事件句柄存储在状态变量中,并在稍后传递给内核过程 op_ev_cancel(),如下例所示:
/* state variable declaration */
Evhandle \evh;
/* procedure interrupt scheduling */
evh = op_intrpt_schedule_call (stime, 22, f, ds_ptr);
/* procedure interrupt cancelling */
op_ev_cancel (evh);
从进程上下文内安排的过程中断,稍后如果该进程上下文仍然存在,将如同在该进程上下文内一样执行。因此,只要该过程定义在进程模型的功能块中,被调用的过程就可以访问该进程的资源,包括流和状态变量。
用途
提供了一种机制,使任意用户编写的过程能够在指定的仿真时间被安排和调用。这是一种对活动进行时间排序的便捷方式,无需专门的进程模型来承担中断捕获和过程调用的职责。通常,该内核过程用于将仿真与外部库或用户编写的仿真过程相衔接。
错误
- 程序中止:内存分配失败。
- 可恢复错误:指定时间 (
<time>) 小于当前时间。 - 可恢复错误:指定时间 (
<time>) 是无效的双精度值。
参考
- 使用内核过程 op_intrpt_schedule_call_mt() 在并行仿真中安排过程调用
- 使用内核过程 op_intrpt_schedule_self() 安排自中断
- 使用内核过程 op_intrpt_schedule_remote() 安排远程中断
- 使用内核过程 op_intrpt_force_remote() 强制远程中断
- 使用内核过程 op_ev_cancel() 取消待处理的中断