op_pk_creation_mod_get()

摘要

获取指定数据包被创建于其中的模块的对象 ID。

语法

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

返回类型

Objid

指定数据包被创建于其中的模块的对象 ID。

在进程上下文之外创建的数据包,其创建模块将被设置为常量 OPC_OBJID_INVALID。

示例

/* obtain a pointer to the arriving packet */
pkptr = op_pk_get (INPUT_STRM);

/* determine the object ID of packet’s creation module */
src_mod_objid = op_pk_creation_mod_get (pkptr);

/* determine the object ID of source node */
src_node_objid = op_topo_parent (src_mod_objid);

/* extract the LAN address of source node */
op_ima_obj_attr_get (src_node_objid, "LAN_Address", lan_address);

/* print out the extracted LAN address */
printf ("Packet just received from node [%s]", lan_address);

详情

新数据包通过下列方式之一进入流通:

  1. 由内核过程 op_pk_create() 或 op_pk_create_fmt() 显式创建
  2. 通过内核过程 op_pk_copy() 复制现有数据包
  3. 对于经由总线或无线链路向多个目的地传输的数据包,由仿真内核自动复制

通过上述方式 (1) 和 (2) 创建的数据包会被赋予全新的创建模块对象 ID 和创建时间值(例外情况是方式 (2) 在进程上下文之外被调用,此时创建模块对象 ID 被设置为常量 OPC_OBJID_INVALID)。通过上述方式 (3) 复制的数据包会被赋予最初传输的数据包的创建信息。

对数据包执行的多数操作不会影响其创建信息。如上所述,经由总线与无线链路的传输可能产生数据包的多个副本,但每个副本都保留原始的创建信息。不过,通过内核过程 op_pk_copy() 显式复制数据包会产生一个具有全新创建信息的复制数据包。

未格式化和已格式化的数据包都可以通过该内核过程进行操作。

用途

提供一种确定数据包创建地点的机制。当需要确定应向哪个对象发送响应或确认数据包时,这通常很有用。另一种可能的用途是将端到端时延(使用内核过程 op_pk_creation_time_get() 计算)与相应的起源模块(或节点)关联起来。

错误

  • 程序中止:Segmentation violation.(由于无效的数据包指针或格式错误的数据包)
  • 程序中止:数据包指针为 NIL。
  • 程序中止:数据包指针指向已销毁的数据包。

参考

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