op_intrpt_type_register()

摘要

将某进程注册为当前执行模块上收到的某特定类型的所有后续中断的直接接收者。这会取代默认行为(默认中断模块的根进程)。

语法

op_intrpt_type_register (intrpt_type, pro_handle)
参数 类型 说明
intrpt_type int 要启用注册的中断类型。中断类型由表 59“Interrupt Type Symbolic Constants“第 15 页列出的符号常量标识。某些中断类型不能用作此参数(参见详情小节)。
pro_handle Prohandle 被指定为接收指定类型中断的直接接收者的进程的句柄。必须是有效(existing an local)进程的句柄。

返回类型

void

无返回值

示例

/* Set up handler processes for special events in order to */
/* avoid having checks for these conditions throughout the */
/* process model. */

/* Create and register a handler to receive the end-simulation interrupt. *./
pro_handle = op_pro_create ("hndlr_end_sim", OPC_NIL);
op_intrpt_type_register (OPC_INTRPT_ENDSIM, pro_handle);

/* Create and register a handler to receive node failure and recovery intrpts. *./
pro_handle = op_pro_create ("hndlr_cond", OPC_NIL);
op_intrpt_type_register (OPC_INTRPT_FAIL, pro_handle);
op_intrpt_type_register (OPC_INTRPT_RECOVER, pro_handle);

详情

默认情况下,除自中断、过程中断和进程中断之外的所有中断都被路由到其到达的模块的根进程。不过,有两种机制可以改变这一行为,使这类中断改为路由到模块内的另一个进程。第一种机制使用内核过程 op_intrpt_type_register() 指定接收某特定类型中断的进程。第二种机制由内核过程 op_intrpt_port_register() 支持,它更为具体,允许在流中断或统计中断到达特定输入端口时将中断直接投递到指定进程。当两者同时生效时,端口注册优先于类型注册。

通过 op_intrpt_type_register() 对进程的注册持续有效,直到针对同一中断类型再次调用该内核过程,从而用另一个进程模型替换已注册的进程模型。默认行为(中断路由到根进程)只需将根进程注册如下即可恢复:

op_intrpt_type_register (OPC_INTRPT_STRM, op_pro_root (op_id_self ()));

Self、Process 和 Procedure 类型的中断在调度时已隐式定义了特定目标,因此该内核过程不会影响它们的处理。

用途

为处理特定中断类型设置独立进程的能力很有用,可用于分解复杂的进程模型,或使这类模型免于处理与其主要功能无直接关系的特殊情形,例如结束仿真中断。

错误

  • 程序中止:内核过程要求进程上下文。(若从处理器或队列之外调用)
  • 程序中止:内存不足,无法创建中断注册表。
  • 程序中止:段违例。(由于进程句柄格式错误)
  • 可恢复错误:进程句柄指向已销毁的进程。
  • 可恢复错误:进程句柄无效。
  • 可恢复错误:进程句柄指向远程进程。
  • 可恢复错误:中断类型(<intrpt_type>)不支持注册。
  • 可恢复错误:中断类型(<intrpt_type>)无法识别。

参考

  • 使用内核过程 op_pro_create() 在当前执行模块的上下文中创建进程
  • 使用内核过程 op_intrpt_port_register() 根据到达端口索引将流中断和统计中断定向到特定进程
  • 使用内核过程 op_pro_root() 获取外围模块根进程的句柄

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