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, ¤t_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>)。 - 程序中止:数据包指针指向已销毁的数据包。
- 程序中止:数据包指针并非指向值向量数据包。
- 可恢复错误:值向量无效。
参考
- 使用内核过程 op_pk_vvec_get() 从值向量数据包中获取值向量
- 使用内核过程 op_pk_vvec_is_set() 判断值向量数据包是否包含值向量
- 使用内核过程 op_vvec_create() 创建新的值向量
- 使用内核过程 op_pk_destroy() 释放与数据包关联的内存