op_intrpt_schedule_self()

摘要

为调用进程安排一个自中断。

语法

op_intrpt_schedule_self (time, code)
参数 类型 说明
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/base);进程模型(acb_fifo);状态(svc_start);enter 执行。

/* get a handle on packet at head of subqueue 0 */
/* (this does not remove the packet) */
pkptr = op_subq_pk_access (0, OPC_QPOS_HEAD);

/* determine the packet’s length (in bits) */
pk_len = op_pk_total_size_get (pkptr);

/* determine the time required to complete */
/* service of the packet */
pk_svc_time = pk_len / service_rate;

/* schedule an interrupt for this process */
/* for the time when service ends. */
op_intrpt_schedule_self (op_sim_time () + pk_svc_time, 0);

/* the server is now busy. */
server_busy = 1;

详情

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

当自中断表示超时或类似事件时,如果它变得不再必要,取消它往往很有用(例如,由于在超时到期之前收到了 ack 而需要撤销超时)。取消中断要求把该内核过程返回的事件句柄存储在状态变量中,并在稍后传递给内核过程 op_ev_cancel(),如下例所示:

/* state variable declaration */
Evhandle \evh;

/* self interrupt scheduling */
evh = op_intrpt_schedule_self (sch_time, 5);

/* self 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