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>) 指向受限对象。

参考

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