op_subq_pk_swap()
摘要
在指定子队列内交换位于两个指定位置的数据包。
语法
op_subq_pk_swap (subq_index, pos_index1, pos_index2)
| 参数 | 类型 | 说明 |
|---|---|---|
subq_index |
int |
目标子队列的数字索引 [子队列流索引从 0 开始,依次递增 1。子队列的数量没有上限,但如果连续使用它们,可以实现内存的节约使用。除了显式的子队列索引,还可以指定抽象子队列选择索引。抽象子队列选择索引通过某个子队列独有的属性来指定该子队列。可接受的抽象子队列选择索引列于表 85“Subqueue Selection Index Symbolic Constants“ 第 26 页。] |
pos_index1 |
int |
待交换的数据包之一在指定子队列内的数字位置索引 |
pos_index2 |
int |
待交换的数据包之一在指定子队列内的数字位置索引 [有关位置索引参数的更多信息,参见 op_subq_pk_remove() 的语法。] |
返回类型
void
无返回值。
示例
/* get a pointer to the subqueue head */
hd_pkptr = op_subq_pk_access (subq_idx, OPC_QPOS_HEAD);
/* get a pointer to the subqueue tail */
tl_pkptr = op_subq_pk_access (subq_idx, OPC_QPOS_TAIL);
/* obtain wait times */
hd_wait = op_q_wait_time (hd_pkptr);
tl_pkptr = op_q_wait_time (tl_pkptr);
/* compare wait times; if necessary, reshuffle */
if (tl_wait > hd_wait)
op_subq_pk_swap (subq_idx, OPC_QPOS_HEAD, OPC_QPOS_TAIL);
详情
本 KP 只能在与队列模块上运行的进程的上下文中调用(或由队列进程直接或间接调用的函数中调用);从处理器上运行的进程或管道级模型调用将导致错误。
注意: 若任一位置索引无效(即小于零,或大于指定子队列中尾部数据包的索引),则不会执行任何交换,并产生可恢复错误。
用途
提供一种在单个子队列内交换两个数据包的机制。许多应用并不使用本 KP,但当需要交换两个数据包时,本 KP 可以在一次调用中完成相当于四个操作(例如两次数据包移除和两次数据包插入)。通常,需要交换的是子队列的前两个数据包,即当“头部”数据包在优先级上低于子队列中的下一个数据包时。
错误
- 程序中止:KP 需要队列上下文。
- 可恢复错误:子队列选择标志(
<flag>)无法识别。 - 可恢复错误:交换位置(
<pos_index1>)和/或(<pos_index2>)无效。
参考
- 使用 KP op_subq_pk_access() 获取子队列中某个数据包的指针,而不将数据包从子队列中移除
- 使用 KP op_subq_pk_remove() 从子队列移除一个数据包,并获取其指针
- 使用 KP op_subq_pk_insert() 将数据包插入子队列
- 使用 KP op_subq_flush() 移除子队列中的所有数据包