op_intrpt_schedule_remote()

摘要

在指定的时间为指定的处理器或队列安排一个远程中断。

语法

op_intrpt_schedule_remote (time, code, mod_objid)
参数 类型 说明
time double 中断的安排时间
[该值是绝对仿真时间,而不是相对于当前仿真时间的延迟。如果“sim_time_quantum“首选项的值不为 0.0,time 将在内部被截断为指定量子(quantum)的整数倍。]
code int 与中断关联的用户定义数字代码
[该值是任意的、用户定义的整数,可用作所安排中断的识别代码;当中断调用进程时,可使用内核过程 op_intrpt_code() 获取该代码。你可以为其指定一个文本字符串,当该代码出现在 ODB 事件横幅和跟踪中时,会连同该代码一起打印。有关详情,参见“Interrupt Code Map“ 第 507 页。]
mod_objid Objid 将接收中断的处理器或队列的对象 ID
[处理器或队列的对象 ID 可通过 Id 包中的多个内核过程获取:op_id_self()、op_topo_child() 和 op_id_from_name()。]

返回类型

Evhandle

所安排中断的事件句柄。

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

示例

摘自:示例模型(models/std/fddi);进程模型(fddi_mac);功能块。

fddi_tk_inject (int address)
	{
	/* Re-insert the token into the ring in response to */
	/* a station registering its intent to send data after */
	/* a dead period on the ring. */
	FIN (fddi_tk_inject (address))

	/* The token is recreated and reinserted onto the ring */
	/* at the specified station which is not necessarily the */
	/* station now requesting the token. */
	/* The station which will reinsert the token is */
	/* asked to do so by means of a remote interrupt. */
	op_intrpt_schedule_remote (op_sim_time (), 0, Fddi_Address_Table [address]);

	FOUT
	}

详情

调用该内核过程会在仿真事件列表上放置一个新事件;这个新事件表示一个安排在指定时间传送的远程中断。事件一经安排,该内核过程就把控制权返回给调用进程,调用进程随即可以自由地进行任何活动。该事件将在安排的仿真时间发生,但不会先于为该特定仿真时间安排的其他更高优先级事件的执行。当所有较早的事件都已执行完毕,且远程中断事件位于仿真事件列表的头部时,其仿真时间被确立为当前仿真时间,事件随即执行。事件的执行会使一个远程中断被传送到指定模块。该模块的进程可以通过内核过程 op_intrpt_code() 获取与中断关联的指定代码。

有时由于条件变化而需要取消远程中断(例如,一个进程安排了一个在特定时间请求路由更新的中断,但在所安排的更新请求传送到远程模块之前,由于其他原因已经收到了更新)。取消中断要求把该内核过程返回的事件句柄存储在状态变量中,并在稍后传递给内核过程 op_ev_cancel(),如下例所示:

/* state variable declaration */
Evhandle \evh;

/* remote interrupt scheduling */
evh = op_intrpt_schedule_remote (stime, 22, mod_objid);

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

用途

提供了一种机制,使一个进程能够远程调用另一个进程,而无需它们之间存在物理数据包流或统计量连线。当一个进程需要提醒另一个进程某件值得关注的事情已经发生时(例如,队列进程在数据包容量饱和时可以中断另一个节点中的处理器),这会很有用。

警告: 远程中断只能传送给处理器和队列,否则会发生错误。

错误

  • 程序中止:内存分配失败。
  • 可恢复错误:指定时间 (<time>) 小于当前时间。
  • 可恢复错误:指定时间 (<time>) 是无效的双精度值。
  • 可恢复错误:对象 ID (<mod_objid>) 超出范围。
  • 可恢复错误:对象 (<mod_objid>) 类型不正确;应为队列或处理器对象。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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