op_q_insert_time()
摘要
获取某个数据包被插入外围队列内某个子队列的时间。
语法
op_q_insert_time (pkptr)
| 参数 | 类型 | 说明 |
|---|---|---|
pkptr |
Packet* |
指向目标数据包的指针 [数据包的指针可以从许多内核过程获得,但在此上下文中最常见的来源是 op_subq_pk_access() 和 op_subq_pk_remove()。] |
返回类型
double
指定数据包被插入外围队列内某个子队列时的仿真时间。
若发生可恢复错误,则返回常量 OPC_TIME_INVALID。
示例
/* determine if queue is empty; if not, process its contents */
if (!op_q_empty ())
{
/* 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);
}
}
}
详情
Q 包的内核过程只能在运行于队列模块上的进程的上下文中调用(或由队列进程直接或间接调用的函数中调用);从运行在处理器上的进程或管道阶段模型中调用它们将导致错误。
该内核过程只应应用于当前包含在外围队列某个子队列中的数据包。对于已从子队列中取出的数据包、尚未插入子队列的数据包,或仅存储在队列进程状态变量指针中的数据包,如果对其应用该内核过程将导致错误。
每当数据包从子队列中移除并重新插入时,其插入时间都会被重置。以下场景描述了这种重置现象:
- 在 T = 5 时,一个数据包进入子队列输入流
- 在 T = 5 时,该数据包被插入某个子队列
- 在 T = 8 时,对该数据包应用该内核过程,它返回数值 5
- 在 T = 10 时,该数据包从子队列中移除,临时存储在状态变量中,然后重新插入另一个子队列
- 在 T = 11 时,对该数据包应用该内核过程,它返回数值 10
用途
提供一种机制来确定指定数据包被插入外围队列内某个子队列的时间。这对于判断处理时间敏感数据包的相对紧迫性,或确定固定时延排队系统的剩余时间,通常很有用。
错误
- 程序中止:段违例。(由于无效的数据包指针或畸形数据包)。
- 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针指向已销毁的数据包 (
<pk_id>)。 - 程序中止:数据包指针指向无主的数据包 (
<pk_id>)。 - 可恢复错误:数据包 (
<pk_id>) 当前未入队。
参考
- 使用内核过程 op_q_wait_time() 确定数据包在队列中等待的时间长度
- 使用内核过程 op_q_stat() 获取队列相关统计量的值
- 使用内核过程 op_subq_stat() 获取子队列相关统计量的值