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>)指向一个受限对象。
参考
- 使用内核过程 op_topo_assoc_count() 确定对象拥有的关联数量
- 使用内核过程 op_ima_obj_attr_get() 获取对象属性的值