op_ima_obj_pos_notification_register()

摘要

使进程模型能够在站点移动时获得通知。

语法

op_ima_obj_pos_notification_register (site_objid, code, options)
参数 类型 说明
site_objid Objid 关注站点的对象 ID(节点或子网)
[站点对象 ID 可以从 Id 和 Topo 包中的多个 KP 获得:op_topo_parent()、op_topo_child()、op_id_from_userid() 和 op_id_from_name()。]
code int 远程中断的代码。
options int 通知选项(参见详情一节)。

返回类型

Compcode

发生错误时为 OPC_COMPCODE_FAILURE(参见错误一节);否则为 OPC_COMPCODE_SUCCESS。

示例

/* set the site to generate an interrupt whenever the parent node's */
/* position is updated */
op_ima_obj_pos_notification_register (op_topo_parent (op_id_self ()),
	1, OPC_IMA_NOTIFY_ONLY_WHEN_CHANGED);

详情

本 KP 不能在处理器或队列之外执行。

可用的选项有:

  • OPC_IMA_NOTIFY_NO_OPTS – 每当仿真内核针对当前时刻重新计算站点位置时,都会投递一个中断。
  • OPC_IMA_NOTIFY_ONLY_WHEN_CHANGED – 仅当重新计算得到的位置与上一次计算的结果不同时才投递中断(因此,静止的节点不会触发事件)。

用途

对于沿轨迹运动的站点,本 KP 非常有用,因为节点的位置只有在某处需要它的位置时(例如发送或接收无线电数据包)才会更新。利用本 KP,进程模型可以请求在站点位置更新时投递一个远程中断。该远程中断将带有 KP 中指定的代码。

错误

  • 程序中止:KP 需要进程上下文。
  • 可恢复错误:对象 ID(<site_objid>)超出范围。
  • 可恢复错误:对象 ID(<site_objid>)指向受限对象。可恢复错误:无法为对象(<site_objid>)设置位置通知回调,因为它不是站点(<type_name>)

参考

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