op_topo_assoc_count()
摘要
获取参考对象中具有指定类型和方向的关联数量。
语法
op_topo_assoc_count (objid, direction, objmtype)
| 参数 | 类型 | 说明 |
|---|---|---|
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_assoc() 和 op_topo_connect() 的先前调用中获得。] |
direction |
int |
关联方向OPC_TOPO_ASSOC_IN:输入关联OPC_TOPO_ASSOC_OUT:输出关联 |
objmtype |
int |
关联的对象元类型 [该值是一个整数代码,指定所关注关联的对象类型(参见表 69“对象类型符号常量”第 19 页)。] |
返回类型
int
指定方向和类型的关联数量。若发生可恢复错误,将返回符号常量 OPC_INT_INVALID 所代表的特殊值。
示例
摘自:示例模型(models/std/sdr);进程模型 (sdr);状态 (INIT);enter execs
/* 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_ASSSOC_OUT,
OPC_OBJTYPE_STRM, i);
op_ima_obj_attr_get (strm_objid, "src stream", &strm);
if (strm != 0)
. . .
}
详情
对象的输入关联和输出关联分别是直接连接到其输入端口和输出端口的对象。有关有效的参考对象/关联类型组合列表,参见表 21 对象与关联类型。
用途
提供了一种确定对象输入或输出关联数量的机制。这对于为对每个关联对象执行某些操作的循环设定边界非常有用。若要获得每个关联的对象 ID,可以使用参考对象 ID 和循环索引调用内核过程 op_topo_assoc()。
错误
- 可恢复错误:对象 ID (<objid>) 超出范围。
- 可恢复错误:关联方向 (<dir>) 无法识别。
- 可恢复错误:对象元类型 (<objmtype>) 无法识别。
- 可恢复错误:对象类型 (<objmtype>) 不支持关联。
- 可恢复错误:关联方向 (<direction>) 不受参考对象支持。
- 可恢复错误:对象 ID (<objid>) 指向受限对象。
参考
- 使用内核过程 op_topo_assoc() 获取关联的对象 ID
- 使用内核过程 op_ima_obj_attr_get() 获取对象属性的值
- 使用内核过程 op_ima_obj_attr_set() 为对象属性赋值
- 使用内核过程 op_topo_child_count() 确定对象的子对象数量
- 使用内核过程 op_topo_object_count() 确定特定类型的对象数量