op_pk_convert_from_vvec()
摘要
将值向量数据包转换为具有指定数据包格式的已格式化数据包。
语法
op_pk_convert_from_vvec (pk_ptr, format_name)
| 参数 | 类型 | 说明 |
|---|---|---|
pk_ptr |
Packet* |
待转换的值向量数据包的指针 [该值向量数据包将被转换为已格式化数据包;所有预定义字段和传输数据信息均不受影响。] |
format_name |
string |
已存在的数据包格式的名称 [这是值向量数据包将要转换成的数据包格式。该数据包格式必须支持转换。] |
返回类型
Compcode
指示转换是否成功完成的完成代码。
[该值可与两个符号常量 OPC_COMPCODE_SUCCESS 和 OPC_COMPCODE_FAILURE 进行比较。]
示例

/* A value vector representing an entire packet has been */
/* completely received on an esys interface. */
/* Create a new opnet packet */
rcv_pkptr = op_pk_create_vvec ();
/* Set the value vector obtained from the esys interface into the packet */
op_pk_vvec_set (rcv_pkptr, rcv_vvec);
/* Transform, in place, the value vector form of the packet to */
/* the named field form of an "ethernet" packet. */
op_pk_convert_from_vvec (rcv_pkptr, "ethernet");
详情
该函数将值向量数据包转换为已格式化数据包。转换不会影响数据包的预定义字段,但原先存储在值向量数据包中的值向量会被销毁。调用时,该函数先从目标数据包中提取值向量,然后将数据包转换为已格式化数据包,其用户自定义字段中的值就如同该已格式化数据包刚刚用 op_pk_create_fmt() 创建出来一样。
警告: 新创建的数据包格式的数据包转换例程被设置为“NONE”,即不做任何事情。在调用本函数之前,必须将所需的转换例程设置为用户提供的例程,或 Riverbed Modeler 提供的某个默认例程(这些默认例程仅适用于很小一部分数据包格式;详见第 5 章“Packet Conversion”第 29 页)。
该内核过程随后调用相关数据包格式的转换方法,并向其传递三个参数:
- 一个数据包指针
- 原先包含在目标数据包中的值向量
- 值向量中包含数据包第一个比特的位置的索引
转换方法通常利用该值向量妥善设置新转换后数据包的各个字段,然后向内核过程返回成功或失败。如果转换方法返回失败,内核过程也返回失败,仿真随之终止。最后,内核过程释放最初从目标数据包中提取的值向量。
转换方法的原型为:
typedef int
default_convert_pk_from_vvec (Packet * pkptr, Vvec_Vector vvec,
int pos)
该函数必须位于一个 .pfp.c 文件中,文件名与函数名的基础部分相匹配。例如,名为 my_convert_pk_from_vvec() 的函数应定义在文件 my_convert.pfp.c 中。
用途
提供一种将值向量数据包转换为已格式化数据包的机制。
错误
- 程序中止:数据包指针引用了无主数据包(
<pk_id>)。 - 程序中止:数据包格式(
<packet_format>)不支持转换。 - 程序中止:数据包 ID(
<pk_id>)无法转换。(数据包未格式化) - 可恢复错误:值向量不属于该客户端。
- 可恢复错误:值向量无效。
- 程序中止:数据包 ID(
<pk_id>)从值向量形式到字段形式的转换失败。
参考
- 使用内核过程 op_pk_type() 确定数据包的类型
- 使用内核过程 op_pk_vvec_is_set() 查看值向量数据包是否包含值向量
- 使用内核过程 op_pk_convert_to_vvec() 将已格式化数据包转换为值向量数据包
- 使用内核过程 op_pk_fields_convert_from_vvec() 遍历数据包的各个字段并调用其转换方法