op_intrpt_force_remote()
摘要
为指定的处理器或队列强制产生一个远程中断。这会立即调用该模块中的相应进程,并暂时挂起当前进程的执行。
语法
op_intrpt_force_remote (code, mod_objid)
| 参数 | 类型 | 说明 |
|---|---|---|
code |
int |
与中断相关联的用户定义数字代码 [该值是一个任意的用户定义整数,可用作被强制中断的标识代码;接收中断的进程可通过内核过程 op_intrpt_code() 获取该代码。您可以分配一个文本字符串,当该代码出现在 ODB 事件横幅和跟踪记录中时,会连同该代码一起打印。有关详情,参见“Interrupt Code Map“ 第 507 页。] |
mod_objid |
Objid |
将接收中断的处理器或队列对象的对象 ID [处理器或队列对象 ID 可从多个内核过程中获取,包括 op_id_self()、op_topo_child() 和 op_id_from_name()。] |
返回类型
void
无返回值
示例
/* if the channel is currently in a collided state, then the packet will be */
/* at the head of the collision subqueue; remove it from there. */
if (!op_subq_empty (INM_COLL_Q))
{
/* extract the packet from the subqueue */
pk = op_subq_pk_remove (INM_COLL_Q, OPC_QPOS_HEAD);
/* install the ship id in global variable */
op_pk_nfd_get (pk, “ship_index”, &Inm_Ship_Id);
/* determine the origin module for this transmission */
/* and notify it of the collision so that it can retransmit */
origin_object_id = op_pk_stamp_mod_get (pk);
op_intrpt_force_remote (INM_PK_STATUS_COLLIDED, origin_object_id);
/* increment accumulator for number of collisions */
num_pk_collided++;
}
详情
该内核过程会使指定模块发生一个强制事件,没有任何延迟或调度,因此仿真事件列表不参与此操作。强制事件会导致远程模块中的相应进程以远程中断方式被立即调用。当远程进程响应中断时,调用进程被挂起;当远程进程进入非强制状态并释放控制权后,该内核过程将把控制权返回给调用进程,调用进程从调用该内核过程之后的语句处继续执行。
指定的用户定义数字代码将通过内核过程 op_intrpt_code() 提供给被中断的进程。
警告: 如果进程以循环模式强制产生中断,可能导致无限中断循环。
对当前进程的子对象强制产生中断是非法的,因为远程中断通常由根进程处理,这可能导致进程调用自身。另参见 op_pro_invoke() 第 17 页。
用途
提供了一种在不要求两者之间存在物理数据包流或统计量连线连接的情况下、从一个进程模型远程且立即调用另一个进程模型的机制。实际上,远程进程模型就像调用进程模型的“子程序”一样被调用。当一个进程模型需要提醒另一个进程模型发生了值得关注的事件、并且后者应在当前仿真时间安排的其他任何中断之前响应该事件时,这很有用。注意,远程中断只能传送给处理器和队列;否则将发生错误。
错误
- 可恢复错误:对象 (
<mod_objid>) 类型不正确;期望的是队列或处理器对象。 - 可恢复错误:无法在进程 (
<process_id>) 处执行中断。该进程已经处于一次调用之中。
参考
- 使用内核过程 op_intrpt_schedule_remote() 调度远程中断
- 使用内核过程 op_intrpt_schedule_self() 调度自中断
- 使用内核过程 op_intrpt_schedule_call() 调度过程中断
- 使用内核过程 op_intrpt_code() 获取与传入自中断相关联的代码