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);
详情
该字段所模拟数据的实际值与仿真无关,因此数据包中只存储该字段的大小。由于信息字段的大小在格式中已自动预定义,该内核过程只执行在格式化数据包内设置信息字段这一功能。无法通过直接调用内核过程来更改格式化数据包中信息字段的大小,但可以通过以下过程实现:
- 使用内核过程
op_pk_name_to_index()或op_pk_nfd_name_to_index()获取字段索引。 - 使用内核过程
op_pk_fd_set()设置信息字段的大小。
通过内核过程 op_pk_nfd_get() 获取信息字段的值没有有效用途;不过该操作不会导致错误,而是将字符串 “unspecified” 复制到传入的值指针中。
目的
提供一种设置数据包内部信息字段值的方法。由于数据包是格式化的,只需指定字段的值;信息字段的大小会自动从格式中查得。该内核过程只应应用于格式化数据包;否则会发生错误
错误
- 与
op_pk_nfd_set()(信息字段版本)相同。
参考
- 与
op_pk_nfd_set()(信息字段版本)相同。