op_pro_root()

摘要

给定模块的对象 ID,获取队列或处理器模块根进程的句柄。

语法

op_pro_root (mod_objid)
参数 类型 说明
mod_objid Objid 需要获取其根进程的队列或处理器模块的对象 ID

返回类型

Prohandle

所给对象 ID 对应模块的根进程的过程句柄。若所提供的模块对象 ID 导致错误,该过程句柄将无效。无效的过程句柄可通过调用内核过程 op_pro_valid() 检测。

示例

/* If the current interrupt is a stream interrupt, accept the arriving packet. */
if (op_intrpt_type () == OPC_INTRPT_STRM)
	{
	pkptr = op_pk_get (op_intrpt_strm ());

	/* This module only receives packets via packet delivery.      */
	/* Determine the object id of the module that sent the packet. */
	src_objid = op_intrpt_source ();

	/* This module is necessarily a queue or processor; determine its root process. */
	sender_root_ph = op_pro_root (src_objid);

	/* Send an acknowledgment in the form of a process interrupt. Use one */
	/* standard propagation delay to emulate the travel time for the ack. */
	op_intrpt_schedule_process (sender_root_ph, op_sim_time () +
		std_prop_delay, ACK);
	}

详情

每个队列或处理器模块内至少有一个活动进程。这就是根进程,它由仿真内核在仿真开始时创建,其类型由模块的进程模型属性指定。该进程不能被销毁,也不能被替换掉其根进程角色。

若已知目标模块的对象 ID,可以通过调用内核过程 op_pro_root() 获取根进程的过程句柄。根据模型配置的不同,可以通过多种方式获取该对象 ID。关于这一主题,请参阅 Id 包和 Topo 包的内核过程。

该内核过程必须以处理器或队列模块的对象 ID 调用,否则将产生可恢复错误并返回无效的事件句柄。因此,如果对所给对象 ID 指向的对象类型有任何疑问,应先使用 op_id_to_type() 测试,以确认其可用。

进程可以通过调用 op_pro_root() 和 op_pro_self() 判断自身是否为其所在模块的根进程;用这种方式获得的两个过程句柄可通过内核过程 op_pro_id() 进行比较,二者相等即表明该进程就是根进程。

用途

该内核过程允许任意进程或用户自定义函数获取指定队列/处理器模块中根进程的句柄。这既有助于进程确定其所在模块的根进程,也有助于判断自身是否就是根进程。有时确定另一个模块的根进程也很有用,以便与之建立直接通信,从而绕过该模块通过 op_intrpt_port_register() 或 op_intrpt_type_register() 建立的任何中断重定向。

错误

  • 可恢复错误:对象 ID(<mod_objid>)无效。
  • 可恢复错误:对象(<mod_objid>)类型不正确;应为队列或处理器对象。
  • 可恢复错误:对象 ID(<objid>)指向受限对象。

参考

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