op_pk_creation_time_get()
摘要
获取指定数据包被创建时的仿真时间。
语法
op_pk_creation_time_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()。] |
返回类型
double
指定数据包被创建时的仿真时间。
示例
/* A packet has arrived at our receiver */
pkptr = op_pk_get (op_intrpt_strm ());
/* Calculate the end-to-end delay for this packet */
pk_create_time = op_pk_creation_time_get (pkptr);
ete_delay = op_sim_time () - pk_create_time;
详情
新数据包通过以下方式之一进入流通:
- 由内核过程 op_pk_create() 或 op_pk_create_fmt() 显式创建
- 通过内核过程 op_pk_copy() 复制现有数据包
- 当数据包通过总线或无线链路向多个目的地传输时,由仿真内核自动复制
通过上述方式 1) 和 2) 创建的数据包会被赋予全新的创建模块对象 ID 和创建时间值(例外情况是方式 2) 在进程上下文之外被调用,此时创建模块对象 ID 被设置为常量 OPC_OBJID_INVALID)。通过上述方式 3) 复制的数据包则被赋予最初传输的数据包的创建信息。
对数据包执行的大多数操作不会影响其创建信息。如上所述,通过总线和无线链路传输可能会创建数据包的多个副本,但每个副本都保留原始的创建信息。然而,通过内核过程 op_pk_copy() 显式复制数据包将产生一个具有全新创建信息的复制数据包。
未格式化和已格式化的数据包都可以通过该内核过程进行操作。
用途
提供一种确定数据包创建时的仿真时间的机制。该内核过程通常用于计算端到端的传输和处理时延,并且可以与内核过程 op_pk_creation_mod_get() 结合使用,以参照不同的源位置比较端到端时延。
错误
- 程序中止:Segmentation violation.(由于无效的数据包指针或格式错误的数据包)
- 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针指向已销毁的数据包。
参考
- 使用内核过程 op_pk_creation_mod_get() 获取数据包创建所在的模块对象 ID
- 使用内核过程 op_pk_stamp() 为数据包打上当前模块和仿真时间的戳记
- 使用内核过程 op_pk_stamp_mod_get() 和 op_pk_stamp_time_get() 从数据包的戳记中获取模块对象 ID 和仿真时间
- 使用内核过程 op_pk_id() 获取数据包的唯一 ID