op_subq_index_map()

摘要

将抽象子队列选择索引转换为显式的子队列索引。

语法

op_subq_index_map (subq_index)
参数 类型 说明
subq_index int 目标子队列的抽象数字索引 [该值应为一个抽象子队列选择索引,通过某个子队列独有的属性来指定该子队列。可接受的抽象子队列选择索引列于表 85“Subqueue Selection Index Symbolic Constants“ 第 26 页。]

返回类型

int

指定子队列的显式数字索引。若发生可恢复错误,将返回常量 OPC_INT_INVALID。

示例

/* extract the head of the slowest subqueue */
pkptr = op_subq_pk_remove (OPC_QSEL_MAX_AVG_DELAY, OPC_QPOS_HEAD);

/* determine packet type */
op_pk_nfd_get (pkptr, "operation", &pk_op);

switch (pk_op)
	{
	case DATA_STREAM_PURGE:
		/* forced flush of subqueue */
		mxdel_subq = op_subq_index_map (OPC_QSEL_MAX_AVG_DELAY);
		op_subq_flush (mxdel_subq);

		/* log statistic tagged with packet’s insert time */
		op_stat_write_t (mxdel_subq, 0.0, op_q_insert_time (pkptr));

		/* destroy the packet */
		op_pk_destroy (pkptr);
		break;
	/* ... */ }

详情

Subq 包的 KP 只能在与队列模块上运行的进程的上下文中调用(或由队列进程直接或间接调用的函数中调用);从处理器上运行的进程或管道级调用它们将导致错误。

如果参数 flag 是一个对应于某个物理子队列的正值(即小于子队列的数量),则本 KP 将直接返回传入的值。

用途

提供一种将抽象子队列指定转换为具体子队列数字索引的机制。子队列可以通过其属性进行抽象标识;例如,某个子队列具有最高的平均时延(由抽象子队列选择索引 OPC_QSEL_MAX_AVG_DELAY 标识),或最少的比特数(由抽象子队列选择索引 OPC_QSEL_MIN_BITSIZE 标识)。大多数 Subq 包的 KP 接受抽象子队列选择索引作为参数,从而实现强大的组合语句。但有时获取子队列的实际数字索引会很方便,尤其是在需要记录子队列的身份以供将来参考(届时选择条件可能不再成立),或者该索引需要用于多个操作时。

错误

  • 程序中止:KP 需要队列上下文。
  • 可恢复错误:子队列选择标志(<flag>)无法识别。

参考

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