op_radio_txch_rxgroup_get()
注意: 需要 Wireless 功能
摘要
获取发射机信道的接收机组。
语法
op_radio_txch_rxgroup_get (txch_objid, count_ptr, rxgroup_pptr)
| 参数 | 类型 | 说明 |
|---|---|---|
txch_objid |
Objid |
请求其接收机组的发射机信道 |
count_ptr |
unsigned int * |
指向计数器的指针,该函数会将此计数器设置为接收机组中的接收机数量。这将指示 rxgroup_pptr 数组的大小。 |
rxgroup_pptr |
Objid ** |
指向一个数组的指针,数组内容为该发射机信道接收机组中的接收机对象 ID;若不存在接收机,则为 OPC_NIL。使用完毕后,应使用 op_prg_mem_free() 释放该数组。 |
返回类型
Compcode
完成代码,指示获取接收机组是否成功。若成功获取接收机组,该过程返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE。
示例
unsigned int num_receivers;
Objid * receivers;
if (op_radio_txch_rxgroup_get (txch, &num_receivers, &receivers)
== OPC_COMPCODE_SUCCESS)
{
if (num_receivers == 0)
{
printf ("Transmitter channel %d has an empty receiver group\n", txch);
}
else
{
unsigned int i;
printf ("Transmitter channel%d has %d receivers in its group:",
txch, num_receivers);
for (i = 0; i < num_receivers; i++)
printf ("%d%s", receivers [i],(i+1 == num_receivers ? "" : ", "));
printf ("\n");
op_prg_mem_free (receivers);
}
}
详情
指定发射机信道的接收机组中的接收机数量将被写入 count_ptr。如果组中包含接收机,该过程将使用 op_prg_mem_alloc() 动态分配一个对象 ID 数组,填入组中各接收机的对象 ID,并通过 rxgroup_pptr 返回该数组。
注意: 该数组必须由该内核过程的调用者释放(使用 op_prg_mem_free())。
用途
提供一种获取发射机信道当前接收机组的机制。
错误
- 可恢复错误:对象 ID (
<objid>) 不是发射机信道。 - 可恢复错误:发射机对象 ID (
<objid>) 指向受限对象。 - 可恢复错误:接收机组大小的返回地址为 NIL。
- 可恢复错误:接收信道 ID 数组的返回地址为 NIL。
参考
- 使用内核过程 op_radio_txch_rxgroup_compute() 可使用滤波器计算接收机组
- 使用内核过程 op_radio_txch_rxgroup_set() 可将接收机组设置为给定的对象 ID 数组
- 使用内核过程 op_radio_txch_rxch_add() 可向发射机信道的组添加一个接收信道
- 使用内核过程 op_radio_txch_rxch_remove() 可从发射机信道的组中移除一个接收信道