op_pk_nfd_set_pkid()
摘要
为指定数据包中的数据包 ID 字段赋值;目标字段通过名称指定。
语法
op_pk_nfd_set_pkid (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 |
OpT_Packet_Id |
要赋给该字段的值 |
返回类型
Compcode
若字段值设置成功,返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE。
示例
OpT_Packet_Id pkt_id;
/* create a formatted packet */
f_pkptr = op_pk_create_fmt ("example_pkt");
/* assign a packet ID field in the packet */
op_pk_nfd_set_pkid (f_pkptr, "fd_pkt_id", pkt_id);
/* send the defined packet out of the processor */
op_pk_send (f_pkptr, OUTSTRM);
详情
如果指定的字段此前未被设置过,新字段的大小将根据数据包格式确定,并累加到数据包的总大小中。
用途
提供了一种在数据包内设置数据包 ID 字段值的方法。由于数据包是已格式化的,只需指定字段的值;字段的类型和大小会自动从格式中获取。该内核过程只应应用于已格式化的数据包,否则会发生错误。
错误
- 与
op_pk_nfd_set()相同。(整数、双精度和数据包字段版本)
参考
- 与
op_pk_nfd_set()相同。(整数、双精度和数据包字段版本)