op_pk_vvec_get()

摘要

从值向量数据包中提取一个值向量。

语法

op_pk_vvec_get (vvec_pk_ptr, value_vector_ptr)
参数 类型 说明
vvec_pk_ptr Packet* 指向包含该值向量的数据包的指针
value_vector_ptr Vvec_Vector* 指向待由数据包内容填充的值向量的指针

返回类型

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 pakcet */
op_pk_vvec_get (pkptr, &pk_vvec);

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

/* Invoke child process to "clock" the bits of the packet */
/* to the external system... */

详情

该函数将值向量数据包内含的值向量放入一个空值向量中。值向量数据包的大小按所移除值向量的大小相应减小,但数据包不会被销毁,仍可再次使用。

注意: 如果作为参数传给 op_pk_vvec_get() 的数据包同时是一个 Sar 段和一个值向量数据包,则该函数会在 value_vector_ptr 中放入该值向量的副本,但不会从值向量数据包中移除该值向量。

用途

提供一种从值向量数据包中移除值向量的机制。

错误

  • 程序中止:数据包指针指向无主数据包(<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