op_pk_creation_time_set()
摘要
更改数据包的创建时间。
语法
op_pk_creation_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 |
新的创建时间 [必须在 0.0 与当前仿真时间之间。如果“sim_time_quantum“首选项的值不为 0.0, time 将在内部被截断为指定时间量子的整数倍。] |
返回类型
Compcode
如果更改成功,返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE
示例
/* declarations */
Packet *uf_pkptr;
/* create an unformatted packet */
uf_pkptr = op_pk_create (64);
/* Set the creation time for this packet */
op_pk_creation_time_set (uf_pkptr, op_sim_time());
详情
调用该函数的进程模型必须拥有待更改的数据包;非进程模型代码可以对任何数据包使用该函数。
用途
为联合仿真提供一种机制,用于重置由值向量表示转换而来的数据包的创建时间。
错误
- 程序中止:Segmentation violation.(由于无效的数据包指针或格式错误的数据包)
- 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针指向已销毁的数据包。
- 程序中止:数据包指针指向无主数据包 (
<pk_id>)。 - 程序中止:数据包创建时间 (
<time>) 必须为正且小于或等于仿真时间 (<current_sim_time>)
参考
- 使用内核过程 op_pk_creation_mod_get() 获取数据包创建所在的模块对象 ID
- 使用内核过程 op_pk_stamp() 为数据包打上当前模块和仿真时间的戳记
- 使用内核过程 op_pk_stamp_mod_get() 和 op_pk_stamp_time_get() 从数据包的戳记中获取模块对象 ID 和仿真时间
- 使用内核过程 op_pk_id() 获取数据包的唯一 ID