op_pk_stamp_time_set()
摘要
设置指定数据包最近一次被打上时间戳时的仿真时间。
语法
op_pk_stamp_time_set (pkptr, time)
| 参数 | 类型 | 说明 |
|---|---|---|
pkptr |
Packet* |
指向目标数据包的指针 [许多内核过程都可以获得数据包指针,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。] |
time |
double |
要设置的仿真时间。 |
返回类型
Compcode
修改成功时返回 OPC_COMPCODE_SUCCESS,否则返回 OPC_COMPCODE_FAILURE
示例
/* declarations */
Packet *uf_pkptr;
double stamp_time;
/* create an unformatted packet */
uf_pkptr = op_pk_create (64);
/* Set the stamp time for this packet */
op_pk_stamp_time_set (uf_pkptr, stamp_time);
详情
调用此函数的进程模型必须拥有待修改的数据包;非进程模型代码可以对任何数据包使用此函数。
用途
为联合仿真提供了一种重置数据包最近一次打时间戳时仿真时间的方法。该内核过程通常与内核过程 op_pk_stamp_mod_set() 配合使用,以参照不同源位置设置端到端时延。
错误
- 程序中止:段违例。(由于无效的数据包指针或格式错误的数据包)
- 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针指向已被销毁的数据包。
- 程序中止:数据包指针指向未被拥有的数据包(
<pk_id>)。 - 程序中止:数据包创建时间(
<time>)必须为正数且不大于仿真时间(<current_sim_time>)
参考
- 使用内核过程 op_pk_stamp() 设置数据包的时间戳
- 使用内核过程 op_pk_creation_mod_get() 和 op_pk_creation_time_get() 获取与数据包创建相关的模块对象 ID 和仿真时间
- 使用内核过程 op_pk_id() 获取数据包的唯一 ID