op_ima_obj_event_notify()
摘要
使链路对象和发射器信道对象能够直接获知某些事件。
语法
op_ima_obj_event_notify (objid, event_type, start_service_time, end_service_time, num_bits, num_packets)
| 参数 | 类型 | 说明 |
|---|---|---|
objid |
Objid |
目标对象的对象 ID [对象 ID 可通过 Id 包和 Topo 包中的多个内核过程获得: op_topo_parent()、op_topo_child()、op_id_from_userid() 和 op_id_from_name()。] |
event_type |
int |
指示所发生事件类型的数值常量 [目前此参数唯一合法的值是 OPC_IMA_PTTXCH_EVENT_PK_DEQUEUE。] |
start_service_time |
double |
指定对象开始处理此事件的时间。 |
end_service_time |
double |
指定对象完成处理此事件的时间。 |
num_bits |
double |
对象处理的比特数。 |
num_packets |
double |
对象处理的数据包数。 |
返回类型
Compcode
完成代码,指示操作是否成功完成。
此代码可与两个符号常量 OPC_COMPCODE_SUCCESS 和 OPC_COMPCODE_FAILURE 进行比较。
示例
摘自 models/std/utilities/oms 中的 oms_bgutil.ex.c。
/* Convert to total bits and total packets. */
num_bits = tx_drate * (full_util_end_time - full_util_start_time);
if (est_job_work_mean == 0.0)
{
num_pks = 0.0;
}
else
{
num_pks = (full_util_end_time — full_util_start_time) / est_job_work_mean;
}
/* Update the built-in link stats. */
op_ima_obj_event_notify (tx_ch_objid, OPC_IMA_PTTXCH_EVENT_PK_DEQUEUE,
full_util_start_time, full_util_end_time, num_bits, num_pks);
详情
此内核过程目前仅限于更新链路和发射器信道对象中的某些统计量。只有以下统计量(point-to-point 组)可以通过此内核过程更新:throughput (bits/sec)、throughput (packets/sec) 和 utilization。
一个对象不能同时处理多次 op_ima_obj_event_notify() 调用。因此,对同一对象的每次调用都应具有由 start_service_time 和 end_service_time 参数指示的唯一服务时间。如果对同一对象连续进行服务时间重叠的调用,仿真内核会将后续事件重新安排到更晚的时间。
用途
在某些情况下,仿真运行中可能包含未纳入常规事件调度机制的事件。因此,某些对象可能需要通过调用 op_ima_obj_event_notify() 直接获知事件。出现这种情况的一种情形是模型中包含后台路由流量。由于该流量是隐式的,没有相应的事件(例如数据包的创建与传输)来触发相关统计量(例如链路对象的吞吐量)的更新。目前,此内核过程的主要用途是更新支持后台利用率流量的链路和发射器信道对象中的统计量。
错误
- 程序中止:段违例。(由于坐标指针无效)
- 可恢复错误:对象
<object_id>的对象状态未定义,因为其类型为(<object_type>)。(当对象既不是链路对象也不是发射器信道对象时发生此错误。) - 可恢复错误:未知事件类型(
<event_type_number>)。(当事件类型不是OPC_IMA_PTTXCH_EVENT_PK_DEQUEUE时发生此错误。) - 可恢复错误:对象 ID(
<site_objid>)指向一个受限对象。
参考
- 使用内核过程 op_pk_deliver() 将数据包投递到远程模块。
- 使用内核过程 op_intrpt_schedule_remote() 中断远程模块。
- 使用内核过程 op_ima_obj_pos_notification_register() 在站点移动时中断当前进程。
- 使用内核过程 op_stat_reg()) 获取引用统计量的句柄。
- 使用内核过程 op_stat_write() 向连接到另一模块的统计量连线写入值。
- 使用内核过程 op_stat_write() 向统计量写入值。
- 使用内核过程 op_stat_write_t() 向统计量写入一对时间-值数据。