op_pk_creation_mod_set()
摘要
修改指定数据包创建模块的对象 ID。
语法
op_pk_creation_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,或 OPC_OBJID_UNIVERSAL |
返回类型
Compcode
指示修改是否成功的完成代码。
如果成功,该内核过程返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE。
示例
/* declarations */
Packet *uf_pkptr;
/* create an unformatted packet */
uf_pkptr = op_pk_create (64);
/* set the object ID of packet’s creation module */
op_pk_creation_mod_set (uf_pkptr, op_id_self());
详情
调用该函数的进程模型必须拥有待修改的数据包;非进程模型代码可以对任何数据包使用该函数。
用途
为联合仿真提供一种方法,用于重置由值向量表示形式转换而来的数据包的创建模块。
错误
- 程序中止:Segmentation violation.(由于无效的数据包指针或格式错误的数据包)
- 程序中止:数据包指针为 NIL。
- 程序中止:数据包指针指向已销毁的数据包。
- 程序中止:数据包指针指向无主数据包 (
<pk_id>)。 - 程序中止:只有模块可以被设置为数据包的创建者。Objid (
<objid>) 为<type>。
参考
- 使用内核过程 op_topo_parent() 将模块对象 ID 转换为其所在节点的对象 ID
- 使用内核过程 op_pk_stamp() 为数据包加盖当前模块与仿真时间的戳记
- 使用内核过程 op_pk_stamp_mod_get() 和 op_pk_stamp_time_get() 从数据包的戳记中获取模块对象 ID 与仿真时间
- 使用内核过程 op_pk_id() 获取数据包的唯一 ID