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