op_pk_ici_set()
摘要
通过将指定的 ICI 指针存储在数据包中,在数据包与 ICI 之间建立关联。这会隐式替换该数据包此前与其他 ICI 的任何关联。
语法
op_pk_ici_set (pkptr, iciptr)
| 参数 | 类型 | 说明 |
|---|---|---|
pkptr |
Packet* |
指向目标数据包的指针 [指向数据包的指针可以从许多内核过程获得,包括 op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。] |
iciptr |
Ici* |
指向目标 ICI 的指针 [指向 ICI 的指针可以从两个内核过程获得: op_ici_create() 返回指向新分配 ICI 的指针(在发送 ICI 的进程中),op_intrpt_ici() 返回与传入中断相关联的 ICI 的指针(在接收 ICI 的进程中)。] |
返回类型
void
无返回值。
示例
/* Obtain the packet and ici that just arrived. */
pkptr = op_pk_get (0);
iciptr = op_intrpt_ici ();
/* Set the ICI pointer in the packet. */
op_pk_ici_set (pkptr, iciptr);
/* Enqueue the packet for servicing. */
op_subq_pk_insert (0, pkptr, OPC_QPOS_TAIL);
详情
新创建数据包中 ICI 指针的初始值为 OPC_NIL。通过该内核过程与数据包关联的 ICI 指针将保留在数据包中,直到被再次调用 op_pk_ici_set() 覆盖,即使该 ICI 已被销毁也是如此。另外,销毁数据包不会自动销毁与该数据包关联的 ICI,因为该 ICI 可能还出于其他目的被引用。
按照惯例,可以在调用该内核过程时将 ICI 指针赋值为 OPC_NIL,从而取消数据包与 ICI 的关联。
用途
提供一种在数据包与 ICI 之间建立关联的机制,方法是将 ICI 的地址装入数据包。当数据包与 ICI 随同一个中断到达、但数据包必须等待处理时,这一点尤其有用。在数据包入队之前,可以将 ICI 指针设置到数据包中,并在开始处理时通过内核过程 op_pk_ici_get() 获取。
错误
- 程序中止:Segmentation violation.(由于无效的数据包指针或格式错误的数据包)
- 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针指向已销毁的数据包。
- 程序中止:数据包指针指向无主数据包 (
<pk_id>)。
参考
- 使用内核过程 op_ici_create() 创建 ICI
- 使用内核过程 op_intrpt_ici() 获取与当前中断关联的 ICI 指针
- 使用内核过程 op_ici_destroy() 释放已处理完毕的 ICI
- 使用内核过程 op_pk_ici_get() 获取数据包中的 ICI 指针