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。
错误
- 程序中止:段错误。(由于格式错误的事件句柄)
- 可恢复错误:事件句柄指向的事件无效或当前未被计划。
参考
- 使用内核过程 op_ev_valid() 判断 Evhandle 是否有效
- 使用内核过程 op_ev_dst_id() 确定事件的目标对象 ID
- 使用内核过程 op_ev_type() 确定事件的类型
- 使用内核过程 op_ev_time() 确定事件的计划时间