op_strm_max_index_out()

摘要

获取连接到外围处理器或队列的任意输出流的最大索引。

语法

op_strm_max_index_out ()
参数 类型 说明
无参数

返回类型

int

任意已连接输出流的最大索引。由于输出流编号从零开始,若模块没有已连接的输出流,将返回 -1。

示例

/* determine the number of output streams */
num_out_strms = op_strm_max_index_out ();

/* loop through each output stream, dealing out packets in round-robin fashion. */
for (i = 0; i <= num_out_strms; i++)
	{
	/* Skip the stream if it is not connected. */
	if (op_strm_connected (OPC_STRM_OUT, i) == OPC_FALSE)
		continue;

	/* Obtain a packet from the source buffer. */
	op_strm_access (IN_STREAM_SRCBUF);

	/* If a packet was made available, forward it to the i_th destination. */
	if (op_strm_empty (IN_STREAM_SRCBUF) == OPC_FALSE)
		{
		pkptr = op_pk_get (IN_STREAM_SRCBUF);
		op_pk_send (pkptr, i);
		}
	}

详情

本内核过程返回的值是所有已连接输出流的最高物理索引(即数据包流对象的 src stream 属性的最大值)。若输出流是稀疏连接的,则返回值与已连接输出流的数量不一定相关。反之,若所有已连接的输出流是连续的,则返回值等于已连接流的数量减一,因为编号从零开始。但无论如何,最大索引(本内核过程返回)加一总是已连接输出流数量的一个上界。

用途

提供一种为连接到其他对象的输出流数量设定上界的机制。当需要对所有已连接输出流执行某项操作、而过程又不具备关于哪些流已连接的内置知识时,这一点很有用。此时,过程可以测试直到并包括本内核过程返回的最大索引的所有输出流,并通过调用内核过程 op_strm_connected() 判定它们是否已连接。

错误

  • 程序中止:内核过程需要过程上下文。

参考

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