op_radio_txch_rxch_remove()
注意: 需要 Wireless 功能
摘要
从发射机信道的接收机组中移除指定的接收信道。
语法
op_radio_txch_rxch_remove (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。
示例
void prop_del_and_drop (SimT_Packet * pkptr)
{
Objid txch_objid, rxch_objid;
/*... code for computing propagation delay... */
/* Remove receiver once pipeline stage is complete */
/* This does not affect the current transmission */
txch_objid = op_td_get_int (pkptr, OPC_TDA_RA_TX_CH_OBJID);
rxch_objid = op_td_get_int (pkptr, OPC_TDA_RA_RX_CH_OBJID);
op_radio_txch_rxch_remove (txch_objid, rxch_objid);
}
详情
如果 rxch_objid 所指的接收信道不在接收机组中,应用程序将生成诊断错误。
用途
提供一种从发射机信道的接收机组中移除一个接收信道的机制。
错误
- 可恢复错误:对象 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_add() 可向发射机信道的组添加一个接收信道