op_pk_send_delayed()

摘要

将指定数据包通过输出数据包流转发,将数据包到达目标模块的时间安排为延迟后的仿真时刻,并释放调用进程对该数据包的拥有权。

语法

op_pk_send_delayed (pkptr, outstrm_index, delay)
参数 类型 说明
pkptr Packet* 指向目标数据包的指针
[数据包的指针可以从许多内核过程中获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。]
outstrm_index int 外围模块的一个输出数据包流的索引
delay double 数据包到达需要延迟的仿真时间量
[必须为正数(或零)。]

返回类型

void

无返回值。

示例

摘自:示例模型(models/std/fddi);进程模型(fddi_mac);状态(TX_DATA);进入执行语句。

/* Send the frame once previous transmissions have completed. */
/* Account for propagation delay as well. */
op_pk_send_delayed (pkptr, FDDI_PHY_STRM_OUT, accum_bandwidth + Fddi_Prop_Delay);

/* Increment THT emulation variable, and consumed bandwidth accumulator. */
tht_value += tx_time;
accum_bandwidth += tx_time;

详情

该内核过程将指定数据包到达目标模块的时间安排下来。到达时间安排在当前仿真时刻加上指定的延迟,对应的事件被加入仿真事件列表。事件一经安排,该内核过程即将控制权交还给调用进程。该事件将在延迟后的仿真时刻发生,但不会先于该特定仿真时刻已安排的其他更高优先级事件的执行。在延迟间隔期间,调用进程可以自由进行任何活动;它与被延迟的数据包不再有任何关联。因此该内核过程可用于建模与数据包传输相关的处理延迟。计划事件执行时,目标模块将收到流中断,表明可通过 op_pk_get() 获取该数据包。

数据包一旦传递给该内核过程,调用进程即失去对该数据包的拥有权。发送进程再以任何内核过程传入同一数据包指针,都会导致数据包拥有权错误。该内核过程要求进程上下文,支持发送格式化与非格式化数据包。

用途

提供一种在单个节点内通过数据包流相连的模块之间传输数据包的机制。该内核过程是 op_pk_send() 的一个变体,适用于建模由调用进程引起的处理或传输延迟。op_pk_send() 的其他变体可在目标模块产生强制或静默到达;而另一组 op_pk_deliver…() 内核过程则提供不需要物理流对象存在的数据包传输。

op_pk_send_delayed() 允许将数据包转发到处理器或队列中运行的其他进程,或转发到发射机模块。

错误

  • 程序中止:段错误。(由无效的数据包指针或畸形数据包引起)
  • 程序中止:数据包指针为 NIL。
  • 程序中止:数据包指针引用已被销毁的数据包。
  • 程序中止:数据包指针引用无主数据包(<pk_id>)。
  • 程序中止:数据包指针引用静态数据包(<pk_id>)。
  • 程序中止:数据包投递在对象(<mod_objid>)、流(<instrm_index>)处失败
  • 程序中止:内核过程要求进程上下文
  • 可恢复错误:输出流索引(<outstrm_index>)超出范围。
  • 可恢复错误:输出流索引(<outstrm_index>)未被占用。
  • 可恢复错误:延迟值(<delay>)超出范围。

参考

  • 使用内核过程 op_pk_send() 发送无延迟的数据包
  • 使用内核过程 op_pk_send_forced() 发送数据包并在目标处立即开始处理
  • 使用内核过程 op_pk_send_quiet() 发送数据包且不在目标模块引起中断
  • 使用内核过程 op_pk_deliver…() 在不使用数据包流的情况下将数据包转发到其他模块
  • 使用内核过程 op_pk_get() 获取到达数据包的指针

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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