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() 从子队列中移除所有数据包