op_pk_total_size_set()

摘要

将指定数据包的总大小设置为指定值(前提是该值有效)。

语法

op_pk_total_size_set (pkptr, total_size)
参数 类型 说明
pkptr Packet* 指向目标数据包的指针
[许多内核过程都可以获得数据包指针,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。]
total_size OpT_Packet_Size 要分配给指定数据包的总大小(以比特计)
[该数值必须为正数或零,否则将发生错误。]

返回类型

Compcode

指示大小修改是否成功的完成代码。

修改成功时,此内核过程返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE。

示例

摘自:示例模型(models/std/fddi);进程模型(fddi_gen);状态(ARRIVAL);enter execs。

/* create a packet to send to mac */
pkptr = op_pk_create_fmt ("fddi_llc_fr");

/* assign its overall size. */
op_pk_total_size_set (pkptr, pklen);

/* assign the time of creation */
op_pk_nfd_set (pkptr, "cr_time", op_sim_time ());

详情

数据包的总大小是 bulk 数据大小与各已设置字段大小之和。总大小可以直接修改:修改 bulk 数据大小、设置或取消设置数据包的字段,或修改数据包各字段的大小。当通过此内核过程直接修改总大小时,bulk 数据大小将按比例修改。

数据包的总大小可以在任何时候修改或访问。未格式化数据包与格式化数据包均可通过此内核过程设置大小。

如果新的总大小小于各字段大小之和,bulk 数据大小将为负数。负的 bulk 数据大小可用于表示减少传输数据量的压缩技术。也可以使用 op_pk_bulk_size_set() 将 bulk 数据大小设置为负数。

**注意:**即使 bulk 数据大小为负数,数据包总大小也必须为正数或零。

用途

提供了一种修改数据包总大小的机制。当数据包应当具有与当前各字段大小无关的特定总大小时,这通常很有用。

错误

  • 程序中止:段违例。(由于无效的数据包指针或格式错误的数据包)
  • 程序中止:数据包指针为 NIL。
  • 程序中止:数据包指针指向已被销毁的数据包。
  • 程序中止:数据包指针指向未被拥有的数据包(<pk_id>)。
  • 可恢复错误:数据包总大小(<size>)为负数。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com