op_pk_nfd_set_pkt()

摘要

为指定数据包中的数据包字段赋值;目标字段通过名称指定。

语法

op_pk_nfd_set_pkt (pkptr, fd_name, value)
参数 类型 说明
pkptr Packet* 目标数据包指针
[数据包指针可以从许多内核过程获得,包括 op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。]
fd_name const char* 目标字段名称
[该名称必须是数据包格式中已定义的字段,否则会发生错误。]
value Packet* 要赋给该字段的值

返回类型

Compcode

若字段值设置成功,返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE。

示例

/* create a formatted packet */
f_pkptr = op_pk_create_fmt ("example_pkt");

/* encapsulate a higher-level packet in the packet */
enc_pkptr = op_pk_create (24);
op_pk_nfd_set_pkt (f_pkptr, "fd_packet", enc_pkptr);

/* send the defined packet out of the processor */
op_pk_send (f_pkptr, OUTSTRM);

详情

如果指定的字段此前未被设置过,新字段的大小将根据数据包格式确定,并累加到数据包的总大小中。

被赋值到字段的数据包会被“封装”在本内核过程所操作的数据包内部,调用该过程的进程将失去对被封装数据包的拥有权。这些被封装的数据包在被 op_pk_fd_get_pkt()(或者,若数据包已格式化,也可选用 op_pk_nfd_get_pkt())解封之前是不可访问的。

数据包类型的字段采用一种特殊的动态尺寸确定技术。当在数据包格式编辑器中定义这种类型的字段时,字段大小在数据表的某一列中指定。如果指定的字段大小设置为“inherited”(继承),字段大小将跟随被封装数据包的大小,从而准确模拟聚合的数据包大小。如果表中此类字段的大小指定为零或正值,则会覆盖任何被封装数据包的大小,从而支持数据压缩的建模。

用途

提供了一种在数据包内设置数据包字段值的方法。由于数据包是已格式化的,只需指定字段的值;字段的类型和大小会自动从格式中获取。该内核过程只应应用于已格式化的数据包,否则会发生错误。

错误

  • 与 op_pk_nfd_set() 相同。(整数、双精度和数据包字段版本)

参考

  • 与 op_pk_nfd_set() 相同。(整数、双精度和数据包字段版本)

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