op_pk_create()
摘要
创建一个具有指定 bulk 数据大小的新的未格式化数据包;该数据包的任何字段都未被设置。
语法
op_pk_create (bulk_size)
| 参数 | 类型 | 说明 |
|---|---|---|
bulk_size |
OpT_Packet_Size |
数据包的 bulk 数据大小(以比特计) [如果该值为负,将发生错误。] |
返回类型
Packet*
指向该内核过程创建的新数据包的指针,若发生可恢复错误则返回 OPC_NIL。
示例
/* determine the length of the packet to be generated */
pklen = op_dist_outcome (len_dist_ptr);
/* create an unformatted packet */
pkptr = op_pk_create (pklen);
/* set the source and destination fields */
op_pk_fd_set (pkptr, SOURCE_FIELD, OPC_TYPE_INTEGER, server_id, 16);
op_pk_fd_set (pkptr, DEST_FIELD, OPC_TYPE_INTEGER, client_id, 16);
/* send the packet to the lower layer protocol */
op_pk_send (pkptr, TRPRT_OUT_STREAM);
详情
新数据包由仿真内核分配,并在调用该内核过程的处理器或队列处进入流通。该数据包是未格式化的,因此其字段只能通过数字索引经由 op_pk_fd…() 内核过程访问。创建时,数据包不含任何字段(即不包含任何默认字段设置)。数据包的 bulk 数据大小被设置为指定的值。
新数据包被赋予一个唯一的数据包 ID,即调用该内核过程时下一个可用的数据包 ID。数据包的创建时间和戳记时间被设置为调用该内核过程时的仿真时间,创建模块和戳记模块被设置为运行调用该内核过程之进程的模块。
用途
提供一种获取空的未格式化数据包的机制。当一组数据必须在网络传输过程中被动态修改(可能以条件决定的不同方式)时,未格式化数据包很有用。此类用途之所以可行,是因为字段数据类型可以随时更改,也可以添加新字段。未格式化(相对于已格式化)数据包的缺点是:字段必须以数字索引(而非助记名称)标识,并且字段设置操作需要指定更多信息。不过,未格式化数据包在字段操作期间的计算开销更小,因为字段是直接索引的,无需进行一系列字符串比较来寻找匹配。
新创建的数据包通常被赋予特定的字段内容,并使用 op_pk_send…() 或 op_pk_deliver…() 系列内核过程从创建模块转发。创建的数据包的指针也可以赋给进程模型的状态变量,存储起来直到需要发送该数据包时为止。
错误
- 程序中止:内存分配失败。
- 可恢复错误:bulk 数据包大小(
<bulk_size>)超出范围。
参考
- 使用内核过程 op_pk_fd_set() 为未格式化数据包的字段赋值
- 使用
op_pk_send…()和op_pk_deliver…()内核过程将数据包发送到另一个模块 - 使用内核过程 op_pk_destroy() 释放不再需要的数据包