op_pk_stamp_time_get()
摘要
获取指定数据包最近一次被打上时间戳时的仿真时间。
语法
op_pk_stamp_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
指定数据包最近一次被打上时间戳时的仿真时间。
示例
/* obtain a pointer to the arriving packet */
pkptr = op_pk_get (INPUT_STRM);
/* determine the packet's stamp time */
stamp_time = op_pk_stamp_time_get (pkptr);
/* compute the gateway-to-gateway transmission delay */
gtg_delay = op_sim_time() - stamp_time;
/* write out the new delay value */
op_stat_write (GTG_DELAY, gtg_delay);
详情
从未通过内核过程 op_pk_stamp() 打时间戳的数据包,其时间戳时间被定义为该数据包最初创建的时间。
对数据包执行的多数操作不会影响其时间戳信息。经由总线链路和无线链路传输可能产生数据包的多个副本,但每个副本都保留原始数据包的时间戳信息。通过内核过程 op_pk_copy() 显式复制数据包,将产生一个与原始数据包具有相同时间戳信息的副本。
未格式化数据包与格式化数据包均可通过此内核过程进行操作。
用途
提供了一种确定数据包最近一次被打上时间戳时仿真时间的机制。该内核过程通常用于计算端到端(或局部)传输与处理时延,并可结合内核过程 op_pk_stamp_mod_get(),参照不同源位置比较端到端时延。
错误
- 程序中止:段违例。(由于无效的数据包指针或格式错误的数据包)
- 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针指向已被销毁的数据包。
参考
- 使用内核过程 op_pk_stamp() 设置数据包的时间戳
- 使用内核过程 op_pk_stamp_mod_get() 获取数据包最近一次被打上时间戳所在模块的对象 ID
- 使用内核过程 op_pk_creation_mod_get() 和 op_pk_creation_time_get() 获取与数据包创建相关的模块对象 ID 和仿真时间
- 使用内核过程 op_pk_id() 获取数据包的唯一 ID