op_ima_obj_command()

摘要

执行指定对象所支持的命令。

语法

op_ima_obj_command (objid, cmd_name)
参数 类型 说明
objid Objid 目标对象的对象 ID
[信道对象的对象 ID 可通过 Topo 包中的内核过程(op_topo_child())获得,该过程作用于接收器或发送器对象的对象 ID;收发器对象的对象 ID 可通过内核过程 op_id_from_name() 获得。]
cmd_name const char* 要执行的命令名称
[这是一个字符串,必须是指定对象所接受的合法命令之一(参见表 64 “Object Command String Symbolic Constants”第 17 页);所支持的对象命令也在详情一节中列出。]

返回类型

Compcode

完成代码,指示操作是否成功完成。

此代码可与两个符号常量 OPC_COMPCODE_SUCCESS 和 OPC_COMPCODE_FAILURE 进行比较。

示例

摘自:示例模型(models/std/eth_net);进程模型(eth_mac);状态(TX_ABORT);enter execs。

/* jamming bit sequence has been transmitted. */
/* stop the remainder of the packet from being */
/* transmitted */
op_ima_obj_command (tx_channel_objid, "abort");

/* if the length of the fragment is greater */
/* than a slot time, this is termed a late collision */
if (frag_time > SLOT_TIME)
	tx_comp_status = STATUS_ERR_LATE_COLL;

详情

命令是对象所支持的、可被进程远程调用的命名内部函数。对象所支持的命令仅限于少数几种特殊用途,如下所列:

表 10-1:按对象类型列出的对象命令

对象类型 支持的命令
点对点链路
总线链路
无线电发射器信道
abort——立即中止当前数据包传输
无线电接收器信道 flush——立即移除所有正在接收过程中的数据包

用途

为进程提供一种以专门方式(即通过执行可接受的命令)远程控制对象的机制。运行进程的模块(即处理器和队列)不支持命令,因为这些对象可以通过 op_intrpt_schedule_remote() 提供的一般远程中断机制进行远程控制。当前所支持的对象命令集仅限于传输与接收问题,支持命令的对象也仅限于广播收发器信道。

错误

  • 程序中止:段违例。(由于 cmd_name 参数格式错误)
  • 可恢复错误:对象 ID(<objid>)超出范围。
  • 可恢复错误:对象(<objid>)不支持使用命令。
  • 可恢复错误:对对象(<objid>)执行命令(<cmd_name>)失败。(由于命令名称不正确,或执行命令时遇到逻辑错误)
  • 可恢复错误:对象 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