op_sar_bitrange_create()
摘要
创建一个比特范围,定义属于单个数据包的一系列连续比特。
语法
op_sar_bitrange_create (start_bit, count, pkt_size, pkt_label)
| 参数 | 类型 | 说明 |
|---|---|---|
start_bit |
OpT_Sar_Size |
比特范围的首比特 [起始比特指的是首比特在原始数据包中的位置。] |
count |
OpT_Sar_Size |
比特范围中连续比特的数量 |
pkt_size |
OpT_Sar_Size |
这些比特所属数据包的大小 [数据包的大小,以比特计。] |
pkt_label |
OpT_Int64 |
这些比特所属数据包的标签 [数据包标签是用户定义的数值,用于标识 Sar 缓冲区内的某个特定数据包。源数据包在被插入 Sar 分段缓冲区时由 op_sar_segbuf_pk_insert() 赋予标签。] |
返回类型
Sar_Bitrange*
比特范围,定义属于单个数据包的某个分段内的一组连续比特。
示例
/* create a new list of SAR bit ranges to assign */
/* bits within incoming vector to packets. */
/* All bits within the vector are assumed to */
/* belong to the next packet in sequence. */
bitrange_ptr = op_sar_bitrange_create (last_start, op_vvec_size_get (incoming_vvec),
MTU_SIZE, sequence_num++);
last_start += op_vvec_size_get (incoming_vvec);
/* append this bitrange pointer to bitrange list being constructed. */
op_prg_list_insert(bitrange_list_ptr, bitrange_ptr, OPC_LISTPOS_TAIL);
详情
比特范围是 Sar 包特有的数据类型,存储分段内比特配置的关键信息。比特范围指定一系列都属于同一数据包的连续比特,该数据包由其用户定义的标签标识。分配给比特范围起始比特的值指定其在该带标签的数据包中的位置。此外,数据包在分段前的总大小也存储在比特范围中。
比特范围不再需要后应予以销毁,以释放与其关联的内存。若无法为新比特范围分配内存,op_sar_bitrange_create() 返回 OPC_NIL。
用途
提供一种创建比特范围的机制。
错误
- 可恢复错误:比特范围数量 (
<count>) 无效。 - 可恢复错误:比特范围起始比特 (
<start>) 无效。 - 可恢复错误:比特范围总大小 (
<packet size>) 无效。
参考
- 使用内核过程 op_sar_bitrange_destroy() 在比特范围不再需要后释放其内存
- 使用内核过程 op_sar_bitrange_info_get() 读取比特范围中包含的信息
- 使用内核过程 op_sar_seg_bitrange_list_get() 获取分段内的比特范围列表
- 使用内核过程 op_sar_seg_create_vvec() 使用值向量和比特范围列表创建新分段