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>)。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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