op_intrpt_schedule_process()

摘要

在指定的时间为特定进程安排一个进程中断。

语法

op_intrpt_schedule_process (pro_handle, time, code)
参数 类型 说明
pro_handle Prohandle 将在指定时间接收中断的进程的句柄。
[Pro 包中的多个内核过程可用于获取进程句柄,包括 op_pro_self()、op_pro_parent() 和 op_pro_root()。]
time double 中断的安排时间
[该值是绝对仿真时间,而不是相对于当前仿真时间的延迟。如果“sim_time_quantum“首选项的值不为 0.0,time 将在内部被截断为指定量子(quantum)的整数倍。]
code int 将与中断关联并经由内核过程 op_intrpt_code() 提供给目标进程的整数值。该值的含义由用户定义,通常用于区分模型化系统中进程中断的各种可能起因。
你可以为其指定一个文本字符串,当该代码出现在 ODB 事件横幅和跟踪中时,会连同该代码一起打印。有关详情,参见“Interrupt Code Map“ 第 507 页。

返回类型

Evhandle

所安排中断的事件句柄。

[该返回值可以存储在状态变量中,以便在后续调用 op_ev_cancel() 时用于识别该中断。]

示例

摘自:示例模型(models/std/x25);进程模型(x25_dce_chan);状态(p6):

else
	{
	/* We came here normally because of a CLEAR REQUEST packet. */
	/* Reset the channel. */
	x25_dce_channel_reset ();
	/* Send a confirmation packet to the DTE. */
	x25_pk_send_local (chan_vars->data_link, chan_vars->number, x25_GFI_BASE, 
		X25C_PT_CLEAR_CONFIRM);
	/* Send a CLEAR INDICATION to the remote end. */
	x25_dce_pk_send_remote (OSIC_N_DISCONNECT_INDICATION, pkptr);
	/* Notify our root process that we can be deleted. The deletion will take */
	/* place after the current invocation of this process completes. */
	op_intrpt_schedule_process (op_pro_parent (op_pro_self ()), op_sim_time(), 
		chan_vars->number);
	}

详情

与其他以特定进程为目标的事件类型(如自中断)一样,进程中断的执行也可能发生在该进程已被销毁之后。这会在所安排的中断时间产生一条诊断错误,且中断不会被传送。对于这种情况,建议(在可能时)使用 op_intrpt_schedule_process() 返回的事件句柄,在目标进程被销毁时取消该事件。

也可以使用这个内核过程为当前进程安排事件,其用法与 op_intrpt_schedule_self() 类似。

如果发生可恢复错误(参见错误一节),该内核过程将返回一个无效的事件句柄。这一状况可以通过调用内核过程 op_ev_valid() 来检测。

如上所述,有时由于条件变化而需要取消进程中断。取消中断要求把该内核过程返回的事件句柄存储在状态变量中,并在稍后传递给内核过程 op_ev_cancel(),如下例所示:

/* state variable declaration */
Evhandle \evh;

/* process interrupt scheduling */
evh = op_intrpt_schedule_process (proch, 5.0, AL_CODE);

/* process interrupt cancelling */
op_ev_cancel (evh);

用途

提供了以延迟方式调用进程的能力,这与 op_pro_invoke() 形成对照——后者允许调用进程,但只能立即调用。此外,op_intrpt_schedule_process() 支持调用当前模块之外的进程,而 op_pro_invoke() 不支持。

进程在协作完成单一任务时通常需要相互调用。例如释放某个资源或通知任务完成;虽然远程中断也能支持这类活动,但该内核过程提供了额外的能力,可以中断特定进程而非整个模块。这样就避免了打断目标模块中的其他进程并让它们充当中间人。

错误

  • 程序中止:该内核过程需要进程上下文。
  • 程序中止:段违例。(由格式错误的进程句柄导致。)
  • 可恢复错误:进程句柄无效。
  • 可恢复错误:进程句柄属于已销毁的进程 (<proc_id>)。
  • 可恢复错误:指定时间 (<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