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>) 无效。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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