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。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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