op_sar_seg_bitrange_list_get()
摘要
返回指定分段中包含的比特范围列表。
语法
op_sar_seg_bitrange_list_get (src_pkptr)
| 参数 | 类型 | 说明 |
|---|---|---|
src_pkptr |
Packet* |
指向数据包的指针 [该数据包必须是分段缓冲区或再分段缓冲区中创建的分段。指向数据包的指针可从许多内核过程获得,例如 op_pk_copy() 和 op_pk_get()。] |
返回类型
List*
指向新创建列表的指针,列表中每个元素都是一个比特范围。
示例
/* retrieve a segment from source buffer. */
segpk_ptr = op_sar_srcbuf_seg_remove (transmit_buf, MTU_SIZE);
/* before converting a segment to bits, get */
/* bit-range information from the segment so */
/* that a segment can be reconstructed later. */
bitrange_list_ptr = op_sar_seg_bitrange_list_get (segpk_ptr);
/* convert the segment to bits and extract its */
/* vector. Destroy the segment once this is */
/* done. */
op_pk_convert_to_vvec (segpk_ptr);
op_pk_vvec_get (segpk_ptr, &vvec);
op_pk_destroy (segpk_ptr);
详情
一个分段可能包含来自单个数据包的不连续比特组,甚至来自不同数据包的比特组。该内核过程提供一个新列表,其中包含分段内的每个比特范围。
与其他列表一样,该函数返回的列表所关联的内存应在列表不再需要时予以释放。
用途
提供一种获取分段内容列表的机制;分段可能包含来自相同数据包的不连续比特或来自不同数据包的比特。
错误
- 程序中止:段违例(由于作为参数传入了空或损坏的数据包指针)
- 可恢复错误:数据包(
<id>)必须是另一个数据包的分段
参考
- 使用内核过程 op_prg_list_free() 移除列表内容但不释放列表本身
- 使用内核过程 op_prg_mem_free() 在释放列表元素后释放该列表
- 使用内核过程 op_prg_list_access() 访问列表中的元素
- 使用内核过程 op_sar_bitrange_info_get() 读取比特范围中包含的信息