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 属性对队列进行排序