op_topo_parent()
摘要
获取指定对象的父对象的对象 ID。
语法
op_topo_parent (child_objid)
| 参数 | 类型 | 说明 |
|---|---|---|
child_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() 的先前调用中获得。] |
返回类型
Objid
父对象的对象 ID。若参数 child_objid 是顶层子网的 ID,则返回符号常量 OPC_OBJID_NULL。
若发生可恢复错误,将返回符号常量 OPC_OBJID_INVALID 所代表的特殊值。
示例
/* Obtain self ID */
myid = op_id_self ();
/* Obtain the attribute values. */
op_ima_obj_attr_get (myid, "address", &my_address);
op_ima_obj_attr_get (myid, "average_interarrival_time", &ia_time);
op_ima_obj_attr_get (myid, "average_service_time", &service_time);
op_ima_obj_attr_get (myid, "ack_service_time", &ack_service_time);
/* Obtain the parent object id and name. */
ppid = op_topo_parent (myid);
op_ima_obj_attr_get (ppid, "name", name);
详情
对该内核过程的连续调用可用于沿对象层次结构向上移动。在一个具有五级对象的示例仿真中,通过五次连续调用该内核过程,即可由子队列对象 ID 逐级获得“顶层”子网(对象 ID = 0),如下所示:
subq_comp_attr_objid = op_topo_parent (subqueue_objid);
queue_objid = op_topo_parent (subq_comp_attr_objid);
node_objid = op_topo_parent (queue_objid);
subnet_objid = op_topo_parent (node_objid);
top_subnet_objid = op_topo_parent (subnet_objid);
注意 subq_comp_attr_objid 是一种内置的复合属性类型。对于用户定义的复合属性:
comp_attr_objid = op_topo_parent (generic_objid);
路径没有父对象,因此如果 child_obj_hndl 引用路径对象,该内核过程将返回无效句柄。
用途
当已知较低层对象的 ID 且需要对较高层对象执行操作时,该内核过程提供了一种沿对象树向上移动的机制。它常用于获取包含当前调用进程所在处理器或队列的节点(进而还有子网)的对象 ID。取得相关节点或子网的对象 ID 后,即可通过内核过程 op_ima_obj_attr_get() 获取在这些层次上赋值的属性的值。
错误
- 可恢复错误:对象 ID (<child_objid>) 超出范围。
- 可恢复错误:对象 ID (<child_objid>) 指向受限对象。
参考
- 使用内核过程 op_id_self() 获取所在处理器或队列模块的对象 ID
- 使用内核过程 op_topo_child() 获取另一对象子对象的对象 ID
- 使用内核过程 op_ima_obj_attr_get() 获取对象属性的值
- 使用内核过程 op_ima_obj_attr_set() 为对象属性赋值