op_pk_vvec_set()

摘要

将一个值向量插入值向量数据包。

语法

op_pk_vvec_set (vvec_pk_ptr, value_vector)
参数 类型 说明
vvec_pk_ptr Packet* 指向值向量数据包的指针
value_vector Vvec_Vector 将放入数据包的值向量
[值向量必须为 bit 类型才能插入值向量数据包。]

返回类型

Compcode

指示值向量是否已成功设置的完成代码。

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

示例

/* Append a "partition" value vector onto the contents of a */
/* value vector packet.                                     */

/* Determine if there is already a value vector in this packet */
if (op_pk_vvec_is_set (pkptr))
	{
	/* There is an existing value vector already in this packet. */
	/* Append the "partition" to the existing value vector.      */

	op_pk_vvec_get (pkptr, &current_vvec);

	end_pos = op_vvec_size_get (current_vvec);
	op_vvec_insert (current_vvec, end_pos, partition_vvec);
	}
else
	{
	/* When op_pk_vvec_set () is called, the Kernel */
	/* takes ownership of the value vector.         */
	/* Therefore, create a duplicate of "partition" */
	/* to install into the value vector packet.     */
	current_vvec = op_vvec_copy (partition_vvec, 0,
		op_vvec_size_get (partition_vvec));
	}

op_pk_vvec_set (pkptr, current_vvec);

详情

所插入的值向量必须为 bit 类型。调用该内核过程时数据包内原有的任何值向量都会被销毁(即释放与其关联的内存)。值向量位于数据包内时,仿真内核即取得其所有权,因此该值向量不能以任何方式被修改。该内核过程调用之后,值向量数据包的大小为值向量大小与 bulk 大小之和。

注意: 如果作为参数传给 op_pk_vvec_set() 的是一个 Sar 段,且该 Sar 段同时是值向量数据包,则在两个值向量大小相同的前提下,该内核过程会用新值向量替换数据包中原有的值向量。

用途

提供一种将值向量插入值向量数据包的机制。

错误

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