op_pk_create_fmt()
摘要
创建一个新的已格式化数据包,其预定义结构由指定的数据包格式描述。
语法
op_pk_create_fmt (format_name)
| 参数 | 类型 | 说明 |
|---|---|---|
format_name |
const char* |
将赋给该数据包的数据包格式名称 [该值是使用数据包格式编辑器创建的数据包格式的名称。指定的数据包格式必须位于模型目录中,否则将发生错误。数据包格式文件在格式名称后附加后缀 .pk.m。] |
返回类型
Packet*
指向该内核过程创建的新数据包的指针,若发生可恢复错误则返回 OPC_NIL。
示例
节选自:示例模型(models/std/fddi);进程模型(fddi_mac);状态(ENCAP)的 enter execs。
/* Compose a mac frame from all these elements */
mac_frame_ptr = op_pk_create_fmt ("fddi_mac_fr");
op_pk_nfd_set (mac_frame_ptr, "svc_class", svc_class);
op_pk_nfd_set (mac_frame_ptr, "dest_addr", dest_addr);
op_pk_nfd_set (mac_frame_ptr, "src_addr", my_address);
op_pk_nfd_set (mac_frame_ptr, "info", pdu_ptr);
if (svc_class == FDDI_SVC_ASYNC)
{
op_pk_nfd_set (mac_frame_ptr, "tk_class", req_tk_class);
op_pk_nfd_set (mac_frame_ptr, "pri", req_pri);
}
/* Assign the frame control field... */
op_pk_nfd_set (mac_frame_ptr, "fc", FDDI_FC_FRAME);
/* Enqueue the frame at the tail of the queue. */
op_subq_pk_insert (0, mac_frame_ptr, OPC_QPOS_TAIL);
详情
新数据包由仿真内核分配,并在调用该内核过程的处理器或队列处进入流通。该数据包按指定的数据包格式在内部格式化,因此某些字段可能被预先赋予了默认值。所创建数据包的初始大小是所有已设置字段大小之和;数据包的 bulk 数据大小与数据包格式无关,由该内核过程设置为零(bulk 数据大小可使用内核过程 op_pk_bulk_size_set() 修改)。
新数据包被赋予一个唯一的数据包 ID,即调用该内核过程时下一个可用的数据包 ID。数据包的创建时间和戳记时间被设置为调用该内核过程时的仿真时间,创建模块和戳记模块被设置为运行调用该内核过程之进程的模块。
用途
提供一种获取具有预定结构和默认内容的已格式化数据包的机制。已格式化数据包面向传输特定的数据集合,因为字段数据类型不能更改,也不能添加新字段。已格式化数据包(相对于未格式化数据包)的优点是字段可以按名称标识,并且字段设置操作需要指定的信息更少。不过,按名称标识字段会带来性能上的代价,因为指定的字段名称必须与数据包格式的字段名称进行字符串比较直到找到匹配。
通常,新创建的数据包被赋予特定的内容,并使用 op_pk_send…() 或 op_pk_deliver…() 系列内核过程从创建模块转发。创建的数据包的指针也可以赋给进程模型的状态变量,存储起来直到稍后需要发送该数据包时为止。
错误
- 程序中止:内存分配失败。
- 程序中止:Segmentation violation.(由于格式错误的 format_name 参数)
- 可恢复错误:数据包格式(
<format_name>)无法识别。 - 可恢复错误:无效的数据包格式(
<format_name>):字段(<field_name>)已被设置。类型为 structure 的字段不能在创建时设置。 - 可恢复错误:无效的数据包格式(
<format_name>):字段(<field_name>)已被设置。类型为 packet 的字段不能在创建时设置。
参考
- 使用内核过程 op_pk_nfd_set() 为已格式化数据包的字段赋值
- 使用
op_pk_send…()和op_pk_deliver…()内核过程将数据包发送到另一个模块 - 使用内核过程 op_pk_destroy() 释放不再需要的数据包