op_pk_fd_get_ptr()
摘要
获取指定数据包中某个结构字段的值;目标字段由数字索引指定。
语法
op_pk_fd_get_ptr (pkptr, field_index, value_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
pkptr |
Packet* |
指向目标数据包的指针。 [指向数据包的指针可以从许多内核过程中获得,包括 op_pk_create()、op_pk_create_fmt()、op_pk_copy()、op_pk_get()、op_subq_pk_access() 和 op_subq_pk_remove()。] |
field_index |
int |
目标字段的数字索引 [该值必须为非负数。] |
value_ptr |
void** |
指向某个变量的指针,该变量将被填入指定字段的值 |
返回类型
Compcode
若字段未能获取则返回 OPC_COMPCODE_FAILURE,否则返回 OPC_COMPCODE_SUCCESS。
示例
{
/* variable declarations */
Packet *pkptr; struct Custom_DS *ds_ptr;
/* obtain an arriving packet */
pkptr = op_pk_get (0);
/* extract a data structure from a packet field */
op_pk_fd_get_ptr (pkptr, 3, (void**)&ds_ptr);
op_pk_destroy (pkptr);
}
详情
该函数会从数据包中移除指定字段。更多信息请参见 op_pk_fd_get() 的详情小节。
目的
提供获取数据包字段值的机制。该内核过程与 op_pk_fd_get() 工作方式完全相同,但仅适用于数据类型为指针的对象属性。完整的目的与详情参见 op_pk_fd_get()。
错误
- 与 op_pk_fd_get() 相同。
参考文献
- 与 op_pk_fd_get() 相同。