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>)指向一个受限对象。
参考
- 使用内核过程 op_ima_obj_attr_set()、op_ima_obj_attr_set_dbl()、op_ima_obj_attr_set_int32()、op_ima_obj_attr_set_objid()、op_ima_obj_attr_set_str() 和 op_ima_obj_attr_set_toggle() 为对象属性赋值
- 使用内核过程 op_intrpt_schedule_remote() 为远程对象安排远程中断
- 使用内核过程 op_pk_deliver() 将数据包投递到远程对象
- 使用内核过程 op_id_self() 获取所在处理器或队列的对象 ID
- 使用内核过程 op_id_from_name() 获取任意对象的对象 ID