op_pk_fd_info_get()
摘要
获取数据包字段及其属性的信息;目标字段由数字索引指定。
语法
op_pk_fd_info_get (pk_ptr, field_index, property, value_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
pk_ptr |
Packet* |
指向目标数据包的指针 |
field_index |
int |
目标字段的索引 |
property |
int |
要获取的字段属性(见详情) |
value_ptr |
void* |
指向某个变量的指针,该变量将被填入指定字段属性的值 |
返回类型
void
无返回值。
示例
/* Determine the size of this field. */
op_pk_fd_info_get (pkptr, fd_index, OPC_PK_FD_PROPERTY_SIZE,
&defined_fd_size);
详情
该内核过程提供了一种获取数据包字段及其属性信息的方式。下表所列常量可作为 property 参数传入。该内核过程会将该属性的值写入指定类型的变量中。
表 13:数据包字段属性
| 常量 | 属性 | 变量类型 |
|---|---|---|
OPC_PK_FD_PROPERTY_CONV_FROM_VVEC_PROC |
指向转换函数的指针 | Pk_Fd_From_Vvec_Proc |
OPC_PK_FD_PROPERTY_CONV_NAME |
字段转换方法 | 字符数组 |
OPC_PK_FD_PROPERTY_CONV_ORDER |
字段转换顺序 | 整数 |
OPC_PK_FD_PROPERTY_CONV_TO_VVEC_PROC |
指向转换函数的指针 | Pk_Fd_To_Vvec_Proc |
OPC_PK_FD_PROPERTY_DEF_VAL_STR |
字段的默认值 | 字符数组 |
OPC_PK_FD_PROPERTY_ENCODING |
字段属性 encoding 的值 | 字符数组 |
OPC_PK_FD_PROPERTY_NAME |
字段名称 | 字符数组 |
OPC_PK_FD_PROPERTY_SIZE |
字段大小(以比特为单位) | 32 位整数(value_ptr 应为 int*) |
OPC_PK_FD_PROPERTY_SIZE_INT64 |
字段大小(以比特为单位) | 64 位整数(value_ptr 应为 OpT_Packet_Size*) |
OPC_PK_FD_PROPERTY_TYPE |
字段的数据类型 | 整数 |
目的
提供一种获取数据包字段及其属性信息的机制。
错误
- 可恢复错误:属性标识符(
<property>)无效。
参考文献
- 使用内核过程 op_pk_fd_get() 和 op_pk_nfd_get() 获取字段的值
- 使用内核过程 op_pk_fd_set() 和 op_pk_nfd_set() 设置字段的值
- 使用内核过程 op_pk_format_info_get() 获取数据包格式的信息