op_topo_assoc()

摘要

获取对象的关联(association)的对象 ID,该关联具有指定的类型、方向和索引。

语法

op_topo_assoc (objid, direction, objmtype, index)
参数 类型 说明
objid Objid 参照对象的对象 ID
[对象 ID 可以从 Id 包的多个内核过程中获得:op_id_self()、op_id_from_userid() 和 op_id_from_name()。此外,对象 ID 也可以从 Topo 包内核过程 op_topo_parent()、op_topo_child() 和 op_topo_connect() 的先前调用中获得。]
direction int 关联的方向
OPC_TOPO_ASSOC_IN 表示输入关联
OPC_TOPO_ASSOC_OUT 表示输出关联
OPC_TOPO_ASSOC_THROUGH 表示吞吐(throughput)关联
objmtype int 关联的对象元类型(meta-type)
[该值是一个整数代码,指定目标关联的对象类型(参见表 69 “Object Type Symbolic Constants“ 第 19 页)。]
index int 目标关联的数字索引
[关联索引从 0 开始,依次递增 1。]

返回类型

Objid

指定的输入或输出关联的对象 ID。若发生可恢复错误,将返回符号常量 OPC_OBJID_INVALID 所代表的特殊值。

示例

摘自:示例模型(models/std/sdr);进程模型(sdr);状态(INIT);enter 执行段。

/* Set up routing and interface tables. */
num_out_assoc = op_topo_assoc_count (loc_mod_objid, OPC_TOPO_ASSOC_OUT,
	OPC_OBJTYPE_STRM);
for (i = 0; i < num_out_assoc; i++)
	{
	strm_objid = op_topo_assoc (loc_mod_objid, OPC_TOPO_ASSOC_OUT,
		OPC_OBJTYPE_STRM, i);
	op_ima_obj_attr_get (strm_objid, "src stream", &strm);
	if (strm != 0)
	. . .
	}

详情

对象的输入和输出关联是直接连接到其输入端口和输出端口的对象(分别对应),或者起始或终止于某个节点的路径(分别对应)。“Through”(贯穿)关联主要用于引用到达、离开或穿过某个特定对象的任何路径,或者引用连接到某条特定路径的任何对象。

表 21 列出了有效的参照对象/关联类型组合。

表 21:对象与关联类型

参照对象类型 In Out Through
site(固定子网;固定节点) site、link、path site、link、path path
link(bus;单工、双工点对点链路) site 发射机 site 接收机 path
path site(目的端) site(源端) 所有连接的节点/链路,所有流经的 demand
demand site(目的端) site(源端) 所有使用的路径
module(processor、queue 等) module 连接 module 连接 无
connection(stream、statistic wire) module module 无
transmitter(点对点、bus、radio) module 连接 link 接收机 无
receiver(点对点、bus、radio) link 发射机 module 连接 无
tap bus、bus 发射机 bus、bus 接收机 无
bus 发射机 无 tap 无
bus 接收机 tap 无 无
bus tap tap 无

在无线建模中,移动站点和卫星站点不能连接到点对点链路或 bus 链路,因此只可能存在路径(path)和 demand 关联。此外,无线域(wireless domain)没有关联。

该内核过程使用强制串行化(forced serialization),如“Multi-Threading Safety“ 第 11 页所述。

用途

提供一种机制,用于获取连接在参照对象输入或输出端上的对象的对象 ID。当进程需要获取或设置属于相邻对象的属性时,这通常是一个有用的函数。例如,运行在连接到发射机的 processor 上的进程可能需要周期性地更改发射机信道的频率;另一种场景可能是进程查询某条出站点对点链路的属性。

错误

  • 可恢复错误:对象 ID(<objid>)超出范围。
  • 可恢复错误:关联方向(<dir>)无法识别。
  • 可恢复错误:对象元类型(<objmtype>)无法识别。
  • 可恢复错误:关联索引(<index>)超出范围。
  • 可恢复错误:对象类型(<objmtype>)不支持关联。
  • 可恢复错误:关联方向(<direction>)不受参照对象支持。
  • 可恢复错误:关联索引(<index>)超过了类型(<objmtype>)的关联数量。
  • 可恢复错误:对象 ID(<objid>)指向一个受限对象。

参考

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