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>)。
参考
- 使用内核过程 op_ici_create() 创建 ICI
- 使用内核过程 op_ici_install() 为出站中断安装 ICI
- 使用内核过程 op_ici_destroy() 释放已处理完毕的 ICI
- 使用内核过程 op_pk_ici_set() 在数据包中设置 ICI 指针