op_q_empty()

摘要

判断外围队列是否完全没有任何数据包。

语法

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

返回类型

Boolean

布尔值,指示外围队列是否为空。

若队列为空,该值为 OPC_TRUE;若队列非空,则为 OPC_FALSE。

示例

/* determine if queue is empty; if not, then process its contents */
if (op_q_empty () == OPC_FALSE)
	{
	/* determine the number of subqueues */
	num_subqs = op_topo_child_count (op_id_self (), OPC_OBJTYPE_SUBQ);

	/* loop through each subqueue */
	for (i = 0; i < num_subqs; i++)
		{
		/* determine the number of packets in subqueue */
		num_pkts = op_subq_stat (i, OPC_QSTAT_PKSIZE);

		/* loop through each packet in subqueue */
		for (j = 0; j < num_pkts; j++)
			{
			/* schedule self interrupt based on packet’s insert time */
			pkptr = op_subq_pk_access (i, j);
			op_intrpt_schedule_self (op_q_insert_time (pkptr) + 0.05, PROC_COMP);
			}
		}
	}

详情

如果队列的任何一个子队列都不包含数据包,则该队列为空。队列最初是空的,因为其所有子队列都是空的。数据包通过内核过程 op_subq_pk_insert() 添加到队列内的一个或多个子队列中;它们通过内核过程 op_subq_pk_remove() 和 op_subq_flush() 从子队列中移除,或通过内核过程 op_q_flush() 从整个队列中移除。

Q 包的内核过程只能在运行于队列模块上的进程的上下文中调用(或由队列进程直接或间接调用的函数中调用);从运行在处理器上的进程或管道阶段模型中调用它们将导致错误。

用途

提供一种机制来判断外围队列是否完全没有数据包。该内核过程通常用作进程模型转移中的条件,或用作 if 语句条件子句中的条件,以括起一组仅在外围队列包含数据包时才应执行的语句。通常,被括起的语句会试图处理队列中的一个或多个数据包,并通过内核过程 op_subq_pk_remove() 将其移除。

错误

  • 程序中止:KP 需要队列上下文。

参考

  • 使用内核过程 op_subq_empty() 判断特定子队列是否没有数据包
  • 使用内核过程 op_subq_stat(),以 OPC_QSTAT_PKSIZE 符号常量作为参数,确定子队列中包含的数据包数量
  • 使用内核过程 op_subq_pk_remove() 从子队列中移除数据包并获得指向它的指针
  • 使用内核过程 op_q_flush() 从队列中移除所有数据包
  • 使用内核过程 op_subq_flush() 从子队列中移除所有数据包

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