op_ev_src_id()

摘要

获取作为指定事件来源的节点、链路或模块的对象 ID。

语法

op_ev_src_id (evhandle)
参数 类型 说明
evhandle Evhandle 标识该事件的事件句柄
[事件句柄可以从本包中的多个内核过程获取,例如 op_ev_current()、op_ev_seek_time() 和 op_ev_next(),以及 op_intrpt_schedule_self() 等其他内核过程。]

返回类型

Objid

作为指定事件来源的模块的对象 ID。

该值可以是节点、链路、处理器、队列、发送机或接收机的对象 ID;对于没有对象作为来源的事件,或者发生错误时,返回常量 OPC_OBJID_INVALID。

示例

/* Count the remote interrupts this module scheduled */
/* by looping through all of events and verifying if */
/* each is remote and from this module.              */
ri_count = 0;
num_events = op_ev_count ();
next_event = op_ev_current ();
for (i = 0; i<num_events; i++)
	{
	if ((op_ev_type (next_event) == OPC_INTRPT_REMOTE) &&
		(op_ev_src_id (next_event) == my_id))
		{
		ri_count++;
		}
	next_event = op_ev_next (next_event);
	}

详情

该内核过程在大多数事件上被调用时返回实际对象的 ID。但对于以下中断类型,它返回常量 OPC_OBJID_KERNEL:

  • begin simulation 中断
  • end simulation 中断
  • 常规中断

由模块源引起的中断包括:

  • 统计中断
  • 流中断
  • 自中断
  • 远程中断
  • 访问中断
  • 过程中断
  • 组播中断

故障中断和恢复中断由网络域源对象引起(返回链路或节点的对象 ID)。

用途

提供了一种确定事件源对象的机制。通过该对象 ID 可以获取更详细的信息,例如对象的类型和属性值。一个典型用途是:将从多个源复用的数据包的进程可以了解哪个源通过哪个输入流连接;也就是说,每当通过输入流接收到一个数据包时,该进程都可以通过调用 op_ev_src_id() 确定该流源的对象 ID。

错误

  • 程序中止:段错误。(由于格式错误的事件句柄)
  • 可恢复错误:事件句柄指向的事件无效或当前未被计划。

参考

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