op_topo_object()

摘要

获取由类型和索引指定的对象的对象 ID。

语法

op_topo_object (objmtype, index)
参数 类型 说明
objmtype int 对象类型
[该值是一个整数代码,指定所关注对象的对象类型(参见表 69“对象类型符号常量”第 19 页)。]
index int 对象的数字索引
[对象索引从 0 开始,每次递增 1,最大值为该类型对象数量减 1。]

返回类型

Objid

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

示例

/* Loop through the bus transmitter channels and abort all transmissions. */
/* Obtain the number of bus transmitter channels in the model. */
txch_count = op_topo_object_count (OPC_OBJTYPE_BUTXCH);
/* Loop through the channels and abort the transmission. */
for (i = 0; i < txch_count; i++)
	{
	ch_id = op_topo_object (OPC_OBJTYPE_BUTXCH, i);
	op_ima_obj_command (ch_id, “abort”);
	}

详情

无。

用途

提供了一种基于对象类型获取对象对象 ID 的机制,无论该对象在对象层次结构中的位置如何。当进程需要获取或设置属于某一类型对象的属性时,这很有用。例如,进程可能需要在仿真开始时将所有总线链路的误码率设置为 0.0。内核过程 op_topo_object_count() 将为循环提供上界,该循环调用 op_topo_object() 获取每条总线链路的对象 ID,随后调用 op_ima_obj_attr_set() 设置误码率属性值。

错误

  • 可恢复错误:对象元类型 (<objmtype>) 无法识别。
  • 可恢复错误:对象索引 (<index>) 超出范围。

参考

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