op_ev_next()

摘要

获取指向指定事件之后那个事件的事件句柄(仅适用于顺序仿真)。

语法

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

返回类型

Evhandle

事件列表中紧接在指定事件之后的事件的事件句柄。

示例

/* For each stream interrupt, print out the information. */
event = op_ev_current ();
while (op_ev_valid (event))
	{
	if (op_ev_type (event) == OPC_INTRPT_STRM)
		{
		printf (“src:%d, dest:%d, stream index:%d, time:%f\n”,
			op_ev_src_id (event), op_ev_dst_id (event),
			op_ev_strm (event), op_ev_time (event));
		}
	event = op_ev_next (event);
	}

详情

对于计划事件,下一个事件是事件列表中的后一个事件。如果是最后一个计划事件,则返回无效的事件句柄。对于连续发生的强制事件,下一个事件被认为是生成当前事件的那个事件。这看起来有些矛盾,但原因在于当前事件执行完毕后,执行将从这里恢复。图 47 说明了在强制事件和计划事件两种情况下 next event(下一个事件)一词的含义。

图 47:下一个事件——强制与计划

下一个事件——强制与计划

用途

提供了一种按预期执行顺序逐步遍历未来事件的机制(当对象或中断优先级被修改以及事件被取消时,执行顺序可能发生变化;不过在该内核过程被调用的时刻,无法预见这些变化)。

**注意:**该内核过程仅在顺序仿真上下文中有效。在并行仿真中,当前时间单元中的事件可能根据各线程的行为以不同的方式执行,此时它将表现为当前事件之后没有任何事件。

错误

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

参考

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