op_intrpt_disable()

摘要

禁止指定类别的中断递送给调用进程,可以无限期禁止,也可以仅禁止此类中断的下一次出现。

语法

op_intrpt_disable (type, code, next)
参数 类型 说明
type int 待禁用中断的类型
[这是一个指定中断类型的整数代码,因而部分定义了待禁用的中断类别(参见表 59 “Interrupt Type Symbolic Constants“ 第 15 页);该代码的可能取值也列于详情一节。]
code int 待禁用中断的数字代码
[这是一个特定的整数数字代码,部分定义了待禁用的中断类别。该值会与传入中断关联的各种代码进行比较。]
next Boolean 指示禁用模式的布尔标志(即 OPC_TRUE 或 OPC_FALSE)。
[该标志应设置为 OPC_TRUE 以仅禁用指定类别的下一次中断;应设置为 OPC_FALSE 以无限期禁用指定类别的中断。]

返回类型

void

无返回值。

示例

节选自:示例模型(models/std/eth_net);进程模型(eth_defer);状态(SPACING);进入执行(enter execs)。

/* schedule an interrupt to mark the end of the */
/* inter-frame gap */
op_intrpt_schedule_self (op_sim_time () + INTERFRAME_SPACING, 0);

/* during the inter-frame gap, ignore all statistic wire interrupts */
op_intrpt_disable (OPC_INTRPT_STAT, FRAME_WAITING_INSTAT, OPC_FALSE);
op_intrpt_disable (OPC_INTRPT_STAT, CARRIER_SENSE_INSTAT, OPC_FALSE);

详情

待禁用的中断类别由中断类型(例如流中断、自中断等)和与中断相关联的数字代码共同指定。type 参数的取值可以取自以下符号常量之一:

  • OPC_INTRPT_ACCESS——访问中断
  • OPC_INTRPT_BEGSIM——开始仿真中断
  • OPC_INTRPT_ENDSIM——结束仿真中断
  • OPC_INTRPT_ESYS_INTERFACE——外部系统中断
  • OPC_INTRPT_ESYS_INTERFACE_EXT——外部系统中断(来自联合仿真器)
  • OPC_INTRPT_FAIL——节点/链路故障中断
  • OPC_INTRPT_MCAST——组播中断
  • OPC_INTRPT_PROCEDURE——过程中断
  • OPC_INTRPT_PROCESS——进程中断
  • OPC_INTRPT_RECOVER——节点/链路恢复中断
  • OPC_INTRPT_REGULAR——常规中断
  • OPC_INTRPT_REMOTE——远程中断)
  • OPC_INTRPT_REMOTE_END_RCV——数据包到达接收端的结束
  • OPC_INTRPT_REMOTE_START_RCV——数据包到达接收端的开始
  • OPC_INTRPT_REMOTE_START_XMT——发送端开始发送数据包时 “split_start_radio_transmission“ 偏好为 TRUE
  • OPC_INTRPT_SELF——自中断
  • OPC_INTRPT_SELF_END_XMT——发送端结束发送数据包
  • OPC_INTRPT_STAT——统计中断
  • OPC_INTRPT_STRM——流中断

code 参数与以下中断类型相关:

  • 自
  • 远程
  • 过程
  • 流(code 表示受影响的输入流索引)
  • 统计线(code 表示受影响的输入统计量索引)
  • 访问(code 表示受影响的输出流索引)
  • 组播
  • 进程

next 标志指示是无限期禁用该类别的中断,还是仅禁用下一次出现。默认情况下,所有类别的中断均处于启用状态。被禁用的中断在发生时即被丢弃,而不是排队,并且永远不会递送给目标进程。

用途

提供了一种在当前模块忽略中断的机制。例如,当建模处理器在一段时间内忙于执行某项任务时,禁用就很有用:当该时间段开始时,进程会为时间段的结束安排一个自中断,并禁用它通常期望接收的所有中断。当该时间段结束时,进程会通过单次调用内核过程 op_intrpt_enable_all(),或一系列对内核过程 op_intrpt_enable() 的调用,来启用所有被禁用的中断。

错误

  • 程序中止:内存分配失败。(由于内存不足,无法保存禁用信息)
  • 程序中止:内核过程需要进程上下文。
  • 可恢复错误:中断类型(<type>)无法识别。

参考

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