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>)
参考
- 使用 KP op_ima_obj_pos_get() 可获取站点的全局位置相关属性。
- 使用 KP op_ima_obj_attr_get_dbl() 可获取站点的单个位置相关属性。