op_pk_nfd_size_set()
摘要
设置命名字段的大小。
语法
op_pk_nfd_size_set (pkptr, fd_name, size)
| 参数 | 类型 | 说明 |
|---|---|---|
pkptr |
Packet* |
目标数据包指针 [数据包指针可以从许多内核过程获得,包括 op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。] |
fd_name |
const char* |
目标字段名称 |
size |
OpT_Packet_Size |
要为该字段设置的大小,以比特计 |
返回类型
Compcode
若字段大小设置成功,返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE。
示例
/* obtain an arriving packet */
pkptr = op_pk_get (0);
/* adjust size of the data field, if necessary */
data_size = op_pk_nfd_size (pkptr, "data fd");
new_data_size = sizeof (new_data) * 8;
if (data_size < new_data_size)
op_pk_nfd_size_set (pkptr, "data fd", new_data_size);
/* put new data in field */
op_pk_nfd_set (pkptr, "data fd", new_data);
详情
无。
用途
提供了一种设置命名字段大小的机制。
错误
- 程序中止:段违例。(由于无效的数据包指针或格式损坏的数据包)
- 程序中止:数据包指针指向无主数据包 (<pk_id>)。
- 可恢复错误:数据包 (<pk_id>) 的类型不包含格式化字段。
- 可恢复错误:数据包 (<pk_id>) 中不存在名为 (<fd_name>) 的字段。
参考
- 使用内核过程
op_pk_nfd_size()确定命名字段的当前大小