op_pk_convert_to_vvec()

摘要

将已格式化数据包转换为值向量数据包。

语法

op_pk_convert_to_vvec (pk_ptr)
参数 类型 说明
pk_ptr Packet* 指向已格式化数据包的指针
[数据包的字段将使用数据包格式中指定的转换方法转换为值向量。]

返回类型

Compcode

指示转换是否成功完成的完成代码。

[该值可与两个符号常量 OPC_COMPCODE_SUCCESS 和 OPC_COMPCODE_FAILURE 进行比较。]

示例

if (op_pk_type (pkptr) != OPC_PK_TYPE_VVEC)
	{
	/* Convert packet to value vector form */
	op_pk_convert_to_vvec (pkptr);
	}

/* Extract the value vector from the converted packet */
op_pk_vvec_get (pkptr, &pk_vvec);

/* The packet is no longer needed */
op_pk_destroy (pkptr);

/* Invoke child process to "clock" bits of value vector to external system... */

详情

该函数将已格式化数据包转换为值向量数据包。转换不会影响数据包的预定义字段。

警告: 新创建的数据包格式的数据包转换例程被设置为“NONE”,即不做任何事情。在调用本函数之前,必须将所需的转换例程设置为用户提供的例程,或 Riverbed Modeler 提供的某个默认例程(这些默认例程仅适用于很小一部分数据包格式;详见第 5 章“Packet Conversion”第 29 页)。

调用时,该函数先创建一个值向量,然后调用目标数据包格式的转换方法,并向其传递三个参数:

  • 指向新创建的值向量的指针
  • 指向目标数据包的指针
  • 值向量中将存放由转换函数生成的第一个比特的位置的索引

通常,转换方法利用目标数据包用户自定义字段的内容向值向量中插入值,然后向内核过程返回成功或失败。若返回失败,内核过程也返回失败,仿真终止。若返回成功,内核过程将目标数据包从已格式化数据包转换为值向量数据包,并在数据包中设置该值向量。

转换方法的原型为:

typedef int
default_convert_pk_to_vvec (Packet * pkptr, Vvec_Vector vvec,
	int pos)

该函数必须位于一个 .pfp.c 文件中,文件名与函数名的基础部分相匹配。例如,名为 my_convert_pk_to_vvec() 的函数应定义在文件 my_convert.pfp.c 中。

注意: 可以向 op_pk_convert_to_vvec() 传入一个 Sar 段。该 Sar 段会成为值向量数据包。用 op_pk_type() 查询时,转换后的数据包是值向量数据包;用 op_sar_pk_is_segment() 查询时,该数据包是 Sar 段。

用途

提供一种将已格式化数据包转换为值向量数据包的机制。

错误

  • 程序中止:数据包指针引用了无主数据包(<pk_id>)。
  • 程序中止:数据包格式(<packet_format>)不支持转换。
  • 程序中止:数据包 ID(<pk_id>)从字段形式到值向量形式的转换失败。
  • 程序中止:数据包 ID(<pk_id>)无法转换。
  • 程序中止:值向量不属于该客户端。
  • 程序中止:值向量无效。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com