op_pk_priority_get()

摘要

获取指定数据包的 priority 属性的值。

语法

op_pk_priority_get (pkptr)
参数 类型 说明
pkptr Packet* 目标数据包的指针 [指向数据包的指针可以从许多内核过程获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。]

返回类型

double

指定数据包的优先级值。

这是用户自定义的值,可以取 double 数据类型允许的任何值。如果数据包尚未设置其 priority 属性,则它具有一个特殊的默认值,即符号常量 OPC_PRIO_NOT_SET。

示例

摘自:示例模型(models/std/base);进程模型(acb_fifo_ms);状态(svc_compl);enter execs。

/* all contiguous packets which have completed service */
/* and are at the head of the queue may be removed and */
/* forwarded. Count how many such packets there are. */
for (j = 1; j < num_pks; j++)
	{
	pkptr = op_subq_pk_access (0, j);
	if (op_pk_priority_get (pkptr) != PK_STATUS_DONESVC)
		break;
	}

详情

数据包的 priority 属性可以在任何时候被修改或访问。未格式化和已格式化的数据包都可以通过该内核过程进行操作。

用途

提供一种确定数据包优先级值的机制。通常,该优先级值用作排序子队列的指引,或用于将新数据包插入已预排序的子队列并保持排序顺序。这些操作由 Subq 包中的内核过程支持,如参考一节所述。然而,由于 priority 属性具有用户定义的含义,并且存在用于设置和获取该属性的内核过程,因此它可以在进程中被用于许多识别与判别应用。

错误

  • 程序中止:段违例。(由于无效的数据包指针或格式错误的数据包)
  • 程序中止:数据包指针为 NIL。
  • 程序中止:数据包指针指向已被销毁的数据包。

参考

  • 使用内核过程 op_pk_priority_set() 为数据包指定 priority 属性
  • 使用内核过程 op_subq_pk_insert(),并将 pos_index 参数设置为符号常量 OPC_QPOS_PRIO,可以以 priority 属性作为确定插入位置的指引,将数据包插入子队列(这要求子队列已按数据包优先级预排序)
  • 使用内核过程 op_subq_sort() 按队列中所含数据包的 priority 属性对队列进行排序

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