op_pk_ici_get()

摘要

获取此前通过内核过程 op_pk_ici_set() 与数据包建立关联的 ICI 的指针。

语法

op_pk_ici_get (pkptr)
参数 类型 说明
pkptr Packet* 指向目标数据包的指针
[指向数据包的指针可以从许多内核过程获得,包括 op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。]

返回类型

Ici*

指向与数据包相关联的 ICI 的指针。

当数据包没有关联的 ICI 时,返回常量 OPC_NIL。

示例

/* Obtain a completed packet. */
pkptr = op_subq_pk_remove (0, OPC_QPOS_HEAD);

/* Obtain the Ici associated with the packet. */
iciptr = op_pk_ici_get (pkptr);

/* Determine on which stream to send the packet. */
op_ici_attr_get (iciptr, "dst_strm", &strm_index);

/* Destroy the ici. */
op_ici_destroy (iciptr);

/* Send the packet out. */
op_pk_send (pkptr, strm_index);

详情

ICI 指针只能通过内核过程 op_pk_ici_set() 设置到数据包中。ICI 指针将保留在数据包中,直到被再次调用内核过程 op_pk_ici_set() 覆盖。数据包被销毁时,ICI 不会被销毁,因为其他数据包或进程模型可能仍持有对该 ICI 的引用并打算使用其内容。

新创建的数据包最初关联的 ICI 指针是常量 OPC_NIL。

用途

提供一种获取已通过内核过程 op_pk_ici_set() 设置到数据包中的 ICI 指针的机制。由于 ICI 常被用于携带与数据包相关的参数(例如指定所请求的服务、优先级、协议类型等),使用 op_pk_ici_set() 在 ICI 与数据包之间建立关联会很方便,这样当数据包处理逻辑需要这些参数时,它们便可随时可用。如果没有这一能力,参数就必须在流中断中从与数据包一同到达的 ICI 中立即获取,并分别存储在数据包内部或用户定义的状态变量中。

错误

  • 程序中止: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