op_subq_stat()
摘要
获取由外围队列自动计算的某个统计量的值;该统计量针对指定子队列,而非整个队列。
语法
op_subq_stat (subq_index, stat_index)
| 参数 | 类型 | 说明 |
|---|---|---|
subq_index |
int |
目标子队列的数字索引 [子队列流索引从 0 开始,依次递增 1。子队列的数量没有上限,但如果连续使用它们,可以实现内存的节约使用。除了显式的子队列索引,还可以指定抽象子队列选择索引。抽象子队列选择索引通过某个子队列独有的属性来指定该子队列。可接受的抽象子队列选择索引列于表 85“Subqueue Selection Index Symbolic Constants“ 第 26 页。] |
stat_index |
int |
目标子队列统计量的数字索引 [这是一个整数代码,代表可能的队列统计量类型之一(参见表 74“Queue Statistic Symbolic Constants“ 第 22 页)。] |
返回类型
double
指定统计量的当前值。若发生可恢复错误,返回常量 OPC_DBL_INVALID。
示例
/* determine if queue is empty; if not, then process its contents */
if (op_q_empty () == OPC_FALSE)
{
/* determine the number of subqueues */
op_ima_obj_attr_get (op_id_self (), "subqueue", &subq_objid);
num_subqs = op_topo_child_count (subq_objid, 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);
}
}
}
详情
本 KP 只能在与队列模块上运行的进程的上下文中调用(或由队列进程直接或间接调用的函数中调用);从处理器上运行的进程或管道级模型调用将导致错误。
用途
提供一种获取子队列状态、操作和性能统计量的机制。共有十二种队列统计量会因本 KP 的查询而计算(即“按需”计算)。将本 KP 与抽象子队列选择索引结合使用——尤其是当子队列选择索引与子队列统计量不同时——提供了一种在单条语句中获取队列信息的强大方式。
错误
- 程序中止:KP 需要队列上下文。
- 可恢复错误:子队列选择标志(
<flag>)无法识别。
参考
- 使用 KP op_q_stat() 获取整个队列范围的统计量的值
- 使用 KP op_stat_local_read() 获取外围队列的某个输入统计量的值