op_pk_nfd_set_info()

摘要

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

语法

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

返回类型

Compcode

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

示例

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

/* assign an integer code to the packet */
op_pk_nfd_set (f_pkptr, "fd_type", DATA_XFER);

/* set the information field in the packet */
op_pk_nfd_set_info (f_pkptr, "fd_data");

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

详情

该字段所模拟数据的实际值与仿真无关,因此数据包中只存储该字段的大小。由于信息字段的大小在格式中已自动预定义,该内核过程只执行在格式化数据包内设置信息字段这一功能。无法通过直接调用内核过程来更改格式化数据包中信息字段的大小,但可以通过以下过程实现:

  1. 使用内核过程 op_pk_name_to_index() 或 op_pk_nfd_name_to_index() 获取字段索引。
  2. 使用内核过程 op_pk_fd_set() 设置信息字段的大小。

通过内核过程 op_pk_nfd_get() 获取信息字段的值没有有效用途;不过该操作不会导致错误,而是将字符串 “unspecified” 复制到传入的值指针中。

目的

提供一种设置数据包内部信息字段值的方法。由于数据包是格式化的,只需指定字段的值;信息字段的大小会自动从格式中查得。该内核过程只应应用于格式化数据包;否则会发生错误

错误

参考

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