op_strm_pksize()

摘要

获取指定输入流中包含的数据包数量。

语法

op_strm_pksize (instrm_index)
参数 类型 说明
instrm_index int 目标输入流的数字索引 [输入流索引从 0 开始,依次递增 1。]

返回类型

int

指定输入流中包含的数据包数量。若发生可恢复错误,将返回常量 OPC_INT_INVALID。

示例

/** loop through all input streams, flushing those that have more **/
/** than one packet queued up within them                         **/

/* determine the number of allocated input streams */
alloc_instrms = op_strm_max_index_in ();

/* loop through each allocated stream */
for (i = 0; i <= alloc_intstrms; i++)
	{
	/* if an input stream contains more than one packet, flush it */
	if (op_strm_pksize (i) > 1)
		op_strm_flush (i);
	}

详情

输入流最初为空。数据包通过两种技术放入输入流:

  • 已连接的输入流接收通过 op_pk_send…() 系列内核过程传输的数据包,其源模块通过物理数据包流与之相连。
  • 未连接的输入流只能接收通过 op_pk_deliver…() 系列内核过程传输的数据包,其源处理器或队列甚至不必与目标模块位于同一节点中。

从输入流中移除数据包同样有两种技术:

  • 数据包可以使用内核过程 op_pk_get() 逐个移除,然后由过程算法加以处理。
  • 当数据包不再有用时,可以使用内核过程 op_strm_flush() 将其成批地破坏性移除。

用途

提供一种确定输入流中排队数据包数量的机制。此内核过程通常用于确定一个循环的边界,该循环将依次移除并处理所有数据包。数据包通过内核过程 op_pk_get() 移除。已在模块输入流中排队、但在关联过程的下一次调用期间未被读入和处理的数据包,将继续保持排队状态,直到在后续某次过程调用中被移除。

错误

  • 程序中止:内核过程需要过程上下文。
  • 程序中止:分配(<n> 个)输入流失败。
  • 可恢复错误:输入流索引(<strm_index>)超出范围。

参考

  • 使用内核过程 op_strm_empty() 判定输入流是否为空
  • 使用内核过程 op_strm_flush() 移除输入流中的所有数据包
  • 使用内核过程 op_pk_get() 从输入流中移除第一个数据包并获得指向它的指针

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