op_pk_stamp_mod_set()
摘要
设置指定数据包最后一次打时间戳(stamp)所在模块的对象 ID。
语法
op_pk_stamp_mod_set (pkptr, objid)
| 参数 | 类型 | 说明 |
|---|---|---|
pkptr |
Packet* |
指向目标数据包的指针 [数据包的指针可以从许多内核过程中获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。] |
objid |
Objid |
要设置的模块对象 ID |
返回类型
Compcode
若修改成功返回 OPC_COMPCODE_SUCCESS,否则返回 OPC_COMPCODE_FAILURE。
示例
/* declarations */
Packet *uf_pkptr;
Objid src_id;
/* create an unformatted packet */
uf_pkptr = op_pk_create (64);
/* Set the stamp module for this packet */
op_pk_stamp_mod_set (uf_pkptr, src_id);
详情
调用此函数的进程模型必须拥有待修改的数据包;非进程模型代码可以对任何数据包使用此函数。
用途
为联合仿真(cosimulation)提供一种重置数据包最后打时间戳位置的方法。通常,该内核过程与内核过程 op_pk_stamp_time_set() 配合使用,以设置来自不同源位置的传输延迟。
错误
- 程序中止:Segmentation violation.(由于无效的数据包指针或格式错误的数据包)
- 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针指向已被销毁的数据包。
- 程序中止:数据包指针指向非本模块拥有的数据包(
<pk_id>)。 - 程序中止:只有模块可以被设置为数据包创建者。Objid(
<objid>)是<type>。
参考
- 使用内核过程
op_pk_stamp()设置数据包的打时间戳信息 - 使用内核过程
op_topo_parent()将模块对象 ID 转换为外围节点的对象 ID - 使用内核过程
op_pk_creation_mod_get()和op_pk_creation_time_get()获取与数据包创建相关的模块对象 ID 和仿真时间 - 使用内核过程
op_pk_id()获取数据包的唯一 ID