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>) 是无效的双精度值。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com