op_pk_priority_set()

摘要

将指定的优先级值赋给指定数据包的 priority 属性。

语法

op_pk_priority_set (pkptr, value)
参数 类型 说明
pkptr Packet* 目标数据包的指针 [指向数据包的指针可以从许多内核过程获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。]
value double 指定数据包的优先级值 [这是用户自定义的值,可以取 double 数据类型允许的任何值。值越高,优先级越高。]

返回类型

void

无返回值。

示例

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

/* acquire the arriving packet */
/* multiple arriving streams are supported. */
pkptr = op_pk_get (op_intrpt_strm ());

/* new packets are stamped to */
/* indicate the packet is waiting for service. */
op_pk_priority_set (pkptr, PK_STATUS_WAITING);

/* attempt to enqueue the packet at tail of subqueue 0 */
if (op_subq_pk_insert (0, pkptr, OPC_QPOS_TAIL) != OPC_QINS_OK)
	{
	/* the insertion failed (due to a full queue)... */
	op_pk_destroy (pkptr);

	/* set flag indicating insertion failed... */
	insert_ok = 0;
	}

详情

数据包的 priority 属性可以在任何时候被修改或访问。在被该内核过程设置之前,数据包 priority 属性的默认值被设置为由符号常量 OPC_PRIO_NOT_SET 表示的特殊值。未格式化和已格式化的数据包都可以通过该内核过程进行操作。

用途

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

错误

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

参考

  • 使用内核过程 op_pk_priority_get() 获取数据包的 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