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>)指向受限对象。
参考
- 使用内核过程 op_id_self () 获取当前执行进程的对象 ID
- 使用内核过程 op_pro_id() 获取进程的唯一整数标识
- 使用内核过程 op_pro_invoke() 使进程立即执行
- 使用内核过程 op_intrpt_schedule_process() 为进程安排未来的中断