op_intrpt_schedule_call_mt()
摘要
在指定的时间安排对指定过程的调用(mutex 安全)。
语法
op_intrpt_schedule_call_mt (time, code, procedure, state_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
time |
double |
中断的安排时间 [该值为绝对仿真时间,或来自表 58 “Interrupt Time Symbolic Constants“ 第 15 页的常量。] |
code |
int |
传递给被调用过程的用户定义数字代码 [该值是任意的、用户定义的整数,可用作所安排调用的识别代码。你可以为其指定一个文本字符串,当该代码出现在 ODB 事件横幅和跟踪中时,会连同该代码一起打印。有关详情,参见“Interrupt Code Map“ 第 507 页。] |
procedure |
SimT_Intrpt_Callback_MT |
所安排事件将要调用的过程 [该值必须是指向 C 函数的指针,该函数接受两个(在并行仿真中为三个)参数(仿真上下文、状态内存指针和整数代码),并执行所需的仿真任务。] |
state_ptr |
void* |
指向传递给被调用过程的数据结构(或简单变量)的指针 |
返回类型
Evhandle
所安排中断的事件句柄。
[该返回值可以存储在状态变量中,以便在后续调用 op_ev_cancel() 时用于识别该中断。]
示例
static void
c3sim_pos_animate (OP_SIM_CONTEXT_ARG_OPT_COMMA void * v_state_ptr, int code)
{
struct Pos_DS *ndp_ds_ptr = (struct Pos_DS *) v_state_ptr;
FIN_MT (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_mt (d, 0, c3sim_pos_animate, &node_pos_ds);
FOUT;
}
详情
该函数的用法与 op_intrpt_schedule_call() 相同,区别是它是 mutex 安全的,可用于并行仿真。
用途
提供了一种 mutex 安全的机制,使任意用户编写的过程能够在并行仿真的指定仿真时间被安排和调用。这是一种对活动进行时间排序的便捷方式,无需专门的进程模型来承担中断捕获和过程调用的职责。通常,该内核过程用于将仿真与外部库或用户编写的仿真过程相衔接。
错误
- 程序中止:内存分配失败。
- 可恢复错误:指定时间 (
<time>) 小于当前时间。 - 可恢复错误:指定时间 (
<time>) 是无效的双精度值。
参考
- 使用内核过程 op_intrpt_schedule_call() 在非并行仿真中安排过程调用
- 使用内核过程 op_intrpt_schedule_self() 安排自中断
- 使用内核过程 op_intrpt_schedule_remote() 安排远程中断
- 使用内核过程 op_intrpt_force_remote() 强制远程中断
- 使用内核过程 op_ev_cancel() 取消待处理的中断