op_pk_transfer_to_vvec()
摘要
根据已格式化数据包的自定义字段创建位序列,然后将该位序列放入指定的值向量。
语法
op_pk_transfer_to_vvec (pk_ptr, vvec, vvec_index)
| 参数 | 类型 | 说明 |
|---|---|---|
pk_ptr |
Packet* |
指向已格式化数据包的指针 [数据包的字段将按照该数据包格式所指定的转换方法写入值向量。] |
vvec |
Vvec_Vector |
已分配的值向量 [该值向量接收由转换方法生成的位序列。值向量必须已经存在。] |
vvec_index |
int |
接收位序列第一个比特的位置索引 [该内核过程使用的转换方法根据已格式化数据包自定义字段的内容生成位序列。此参数指定在值向量中插入该位序列的位置。] |
返回类型
Compcode
完成代码,指示位序列是否已成功放入值向量。
[该值可与两个符号常量 OPC_COMPCODE_SUCCESS 和 OPC_COMPCODE_FAILURE 进行比较。]
示例
if (op_npk_field_type (pkptr, "payload") == OPC_FIELD_TYPE_PACKET)
{
/* Extract the encapsulated packet */
op_pk_nfd_get (pkptr, "payload", &encap_pkptr);
/* Have a bit representation of the encapsulated packet */
/* written into our value vector. */
op_pk_transfer_to_vvec (encap_pkptr, vvec, vvec_pos);
/* Install the encapsulated packet back into the original packet */
op_pk_nfd_set (pkptr, "payload", encap_pkptr);
}
详情
该函数创建已格式化数据包内容的位表示,并将生成的位序列放入值向量。
警告: 新创建的数据包格式的数据包转换例程被设置为“NONE”,即不做任何事情。在调用本函数之前,必须将所需的转换例程设置为用户提供的例程,或 Riverbed Modeler 提供的某个默认例程(这些默认例程仅适用于很小一部分数据包格式;详见第 5 章“Packet Conversion”第 29 页)。
该函数被调用时,会调用目标数据包格式的转换方法,并向其传递三个参数:
- 一个 bit 类型的值向量指针(
Vvec_Vector) - 一个指向目标数据包的指针
- 值向量中用于存放转换函数生成的第一个比特的位置索引
通常,转换方法利用目标数据包自定义字段的内容向值向量写入数值,然后向内核过程返回成功或失败。原始数据包不受该内核过程的影响。
注意: 如果作为参数传给 op_pk_transfer_to_vvec() 的是一个 Sar 段,且该 Sar 段同时是值向量数据包,则数据包内的值向量会被复制到目标值向量。如果该数据包是 Sar 段但并非值向量数据包,则会将该段比特范围的位表示传输到目标值向量。
用途
提供一种创建已格式化数据包内容的位表示并将生成的位序列放入值向量的机制。
错误
- 程序中止:数据包指针指向无主数据包(
<pk_id>)。 - 程序中止:数据包格式(
<format_name>)不支持转换。 - 程序中止:数据包 ID(
<pk_id>)无法转换。 - 可恢复错误:值向量不属于调用者
- 可恢复错误:值向量无效。
参考
- 使用内核过程 op_pk_type() 判断数据包的类型
- 使用内核过程 op_pk_vvec_set() 将值向量插入值向量数据包
- 使用内核过程 op_pk_convert_to_vvec() 将已格式化数据包转换为值向量数据包