op_sar_srcbuf_seg_remove()
摘要
从指定源缓冲区(分段缓冲区或再分段缓冲区)的头部移除指定长度的分段。返回指向被移除分段的指针。
语法
op_sar_srcbuf_seg_remove (sb_hndl, bit_count)
| 参数 | 类型 | 说明 |
|---|---|---|
sb_hndl |
Sbhandle |
标识目标源缓冲区的句柄 [该值必须标识一个 Sar 源缓冲区(即分段缓冲区或再分段缓冲区)。Sar 缓冲区句柄在通过内核过程 op_sar_buf_create() 创建缓冲区时获得。] |
bit_count |
OpT_Sar_Size |
要从缓冲区移除的分段中的比特数 [该值为整数,而非某些 Sar 内核过程 bit_count 参数所使用的 double,因为 Sar 分段的最大尺寸小于整数的最大值。] |
返回类型
Packet*
指向从指定源缓冲区移除的分段数据包的指针。
示例
/* Obtain an arriving source packet. */
src_pkptr = op_pk_get (HLP_INSTRM);
/* Determine the size of the source packet. */
rem_size = op_pk_total_size_get (src_pkptr);
/* Insert the source packet into segmentation buffer. */
op_sar_segbuf_pk_insert (seg_sbh, src_pkptr, pk_seq_num++);
/* Remove and send the first segment associated with arriving packet. */
seg_pkptr = op_sar_srcbuf_seg_remove (seg_sbh, SEG_SIZE);
op_pk_send (seg_pkptr, LLP_OUTSTRM);
/* Compute new remainder of source packet
rem_size -= SEG_SIZE;
/* If there is a remainder of source packet, schedule next segment transmission. */
if (rem_size > 0)
op_intrpt_schedule_self (op_sim_time () + SEG_TX_TIME, SEG_TX_CODE);
详情
bit_count 参数请求一定长度的分段;然而,有几个因素会影响该内核过程实际获得的分段是否具有请求的长度。如果缓冲区中的比特数小于请求的分段长度,或者缓冲区设置了数据包边界选项且缓冲区头部的比特与一个剩余比特数少于请求分段长度的源数据包关联,则分段将只包含可用数据比特的数量。然而,如果缓冲区设置了分段填充选项,则即使被移除分段可用的数据比特数小于分段请求的长度,分段也会被填充到请求的长度。填充比特不会计入由填充分段重组出的源数据包的大小。
用途
提供一种从分段缓冲区或再分段缓冲区移除 Sar 分段的机制。这是获取新 Sar 分段的两种技术之一(另一种是通过内核过程 op_sar_srcbuf_seg_access() 从源缓冲区访问分段)。Sar 分段一旦从源缓冲区移除,即可作为普通数据包处理(即通过链路发送、存储在队列中、复制、销毁)。
错误
- 标准 Sar 错误(见表 15)
- 程序中止:比特数值(
<bit_count>)必须大于 0。 - 程序中止:缓冲区类型(重组)对该内核过程无效,应为(分段或再分段)。
- 程序中止:超出虚拟内存限制。分配的对象过多。
- 可恢复错误:对象块分配失败 / 对象类型(
<ob_type>)。
参考
- 使用内核过程 op_sar_srcbuf_seg_access() 从(再)分段缓冲区的头部复制一个 Sar 分段
- 使用内核过程 op_sar_srcbuf_bits_flush() 从(再)分段缓冲区清除由局部比特索引和长度标识的比特范围
- 使用内核过程 op_sar_segbuf_pk_insert() 将源数据包插入分段缓冲区的尾部
- 使用内核过程 op_sar_rsgbuf_seg_insert() 将 Sar 分段插入再分段缓冲区的尾部