op_sar_seg_create_vvec()
摘要
创建一个内容为值向量的新分段。
语法
op_sar_seg_create_vvec (value_vector, bitrange_list)
| 参数 | 类型 | 说明 |
|---|---|---|
value_vector |
Vvec_Vector* |
用作分段比特内容的值向量 [将值向量放入新创建的分段中。] |
bitrange_list |
List* |
分段比特内容的比特范围列表 [该列表必须由定义值向量中各比特所属数据包的比特范围组成。] |
返回类型
Packet*
指向新创建分段的指针,该分段以值向量作为其比特内容。
示例
/* When enough bits have been received from the external system to */
/* reconstruct a segment, recreate the SAR segment. */
op_esys_port_vector_get (op_intrpt_esys_port (), vector, OPC_VVEC_VECTOR_END);
/* segments are 384 bits in length. */
if (op_vvec_size_get (vector) == 384)
{
/* all bits are present. */
/* use the bitrange list previously */
/* stored as the 'table of contents' */
/* for the bits of the segment being */
/* created. */
segpk_ptr = op_sar_seg_create_vvec (vector, bitrange_list_ptr);
/* send the segment to higher layer for */
/* reassembly. */
op_pk_send (segpk_ptr, 0);
}
详情
该内核过程创建的分段在被查询时会自我标识为分段数据包。此外,当作为参数传递给内核过程 op_pk_type() 时,该分段会自我标识为值向量数据包。用该内核过程创建的分段可以插入其他缓冲区,并可像其他任何 Sar 分段一样进行操作。
作为参数传递给 op_sar_seg_create_vvec() 的值向量必须是比特(bit)类型。作为参数传递的值向量的大小必须等于比特范围列表中包含的每个比特范围的 “count” 属性之和。注意,每个比特范围的 start_bit 属性指的不是值向量中的起始元素,而是起始比特在原始数据包中的位置。
用途
提供一种创建分段的机制;分段可以包含来自相同数据包的不连续比特或来自不同数据包的比特。
错误
- 可恢复错误:无法创建分段数据包,因为值向量大小与比特范围列表的 count 值不匹配。
- 可恢复错误:值向量无效。
参考
- 使用内核过程 op_vvec_create() 创建新的值向量
- 使用内核过程 op_sar_bitrange_create() 创建新的比特范围
- 使用内核过程 op_prg_list_create() 分配一个新的空列表
- 使用内核过程 op_prg_list_insert() 向列表中插入新元素