op_radio_txch_rxch_add()
注意: 需要 Wireless 功能
摘要
将指定的接收信道添加到指定发射机信道的接收机组中。
语法
op_radio_txch_rxch_add (txch_objid, rxch_objid)
| 参数 | 类型 | 说明 |
|---|---|---|
txch_objid |
Objid |
要向其接收机组添加接收信道 rxch_objid 的发射机信道的对象 ID;或 OPC_OBJID_UNIVERSAL,表示添加到所有发射机信道。 |
rxch_objid |
Objid |
要添加到发射机信道 txch_objid 的接收机组中的接收信道的对象 ID。 |
返回类型
Compcode
完成代码,指示添加接收信道是否成功。若接收信道被成功添加到组中,该过程返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE。
示例
/* Make sure own receiver channel is included in group */
Objid proc_id, comp_id, xmit_id, xmit_ch_id, rcvr_id, rcvr_ch_id;
proc_id = op_id_self ();
xmit_id = op_topo_assoc (proc_id, OPC_TOPO_ASSOC_OUT, OPC_OBJTYPE_RATX, 0);
comp_id = op_topo_child (xmit_id, OPC_OBJTYPE_COMP, 0);
xmit_ch_id = op_topo_child (comp_id, OPC_OBJTYPE_RATXCH, 0);
rcvr_id = op_topo_assoc (proc_id, OPC_TOPO_ASSOC_IN, OPC_OBJTYPE_RARX, 0);
comp_id = op_topo_child (rcvr_id, OPC_OBJTYPE_COMP, 0);
rcvr_ch_id = op_topo_child (comp_id, OPC_OBJTYPE_RARXCH, 0);
op_radio_txch_rxch_add (xmit_ch_id, rcvr_ch_id);
详情
如果该信道已在接收机组中,应用程序将生成诊断错误。
用途
提供一种向发射机信道的接收机组添加一个接收信道的机制。
错误
- 可恢复错误:对象 ID (
<objid>) 不是发射机信道。 - 可恢复错误:发射机对象 ID (
<objid>) 指向受限对象。 - 可恢复错误:对象 ID (
<objid>) 不是接收信道。 - 可恢复错误:接收机对象 ID (
<objid>) 指向受限对象。 - 可恢复错误:内部内存分配错误,接收机组未改变。
- 诊断错误:试图将接收信道 (
<objid>) 添加到发射机信道 (<objid>) 的接收机组,接收机已存在于组中。
参考
- 使用内核过程 op_radio_txch_rxgroup_get() 可获取当前的接收机组
- 使用内核过程 op_radio_txch_rxgroup_set() 可将接收机组设置为给定的对象 ID 数组
- 使用内核过程 op_radio_txch_rxgroup_compute() 可使用滤波器计算接收机组
- 使用内核过程 op_radio_txch_rxch_remove() 可从发射机信道的组中移除一个接收信道