op_sar_srcbuf_seg_access()
摘要
从指定源缓冲区(分段缓冲区或再分段缓冲区)的头部复制指定长度的分段。返回指向该分段的指针。
语法
op_sar_srcbuf_seg_access (sb_hndl, bit_count)
| 参数 | 类型 | 说明 |
|---|---|---|
sb_hndl |
Sbhandle |
标识目标源缓冲区的句柄 [该值必须标识一个 Sar 源缓冲区(即分段缓冲区或再分段缓冲区)。Sar 缓冲区句柄在通过内核过程 op_sar_buf_create() 创建缓冲区时获得。] |
bit_count |
OpT_Sar_Size |
缓冲区中被访问分段的比特数 [该值为整数,而非某些 Sar 内核过程 bit_count 参数所使用的 double,因为 Sar 分段的最大尺寸小于整数的最大值。] |
返回类型
Packet*
指向在指定源缓冲区中被访问的分段数据包的指针。
示例
/* Determine interrupt type. */
intrpt_type = op_intrpt_type ();
/* Process self interrupt. */
if (intrpt_type == OPC_INTRPT_SELF)
{
/* Process segment time-out event. */
if (op_intrpt_code () == SEG_TIME_OUT)
{
/* Generate another copy of last sent segment. */
seg_pkptr = op_sar_srcbuf_seg_access (seg_sbh, last_seg_size);
/* Retransmit the new segment copy, and set retransmit flag. */
op_pk_send (seg_pkptr, TX_OUTSTRM);
seg_rtx = 1;
}
}
详情
从 Sar 缓冲区访问数据包不会将复制的比特从缓冲区移除;它们保留在缓冲区中,可用于进一步复制或最终的移除操作。生成多个冗余 Sar 分段并通过网络的不同路径发送到同一目的地的场景,通常不需要 Sar 软件包的使用者对分段的去向进行精细的跟踪。目的地的重组缓冲区会忽略插入的冗余比特范围,Sar 软件包会跟踪所有对源数据包的未处理引用。
bit_count 参数请求一定长度的分段;然而,有几个因素会影响该内核过程实际获得的分段是否具有请求的长度。如果缓冲区中的比特数小于请求的分段长度,或者缓冲区设置了数据包边界选项且缓冲区头部的比特与一个剩余比特数少于请求分段长度的源数据包关联,则分段将只包含可用数据比特的数量。然而,如果缓冲区设置了分段填充选项,则即使被访问分段可用的数据比特数小于分段请求的长度,分段也会被填充到请求的长度。填充比特不会计入由填充分段重组出的源数据包的大小。
用途
提供一种从分段缓冲区或再分段缓冲区复制 Sar 分段的机制。访问 Sar 分段是将其从源缓冲区移除的替代方式,在出现需要重新生成分段的情况时(例如需要重传分段时)很有用。如果从源缓冲区访问了一个分段,而后续情况表明不需要重新生成它,则可通过内核过程 op_sar_srcbuf_bits_flush() 从缓冲区头部清除该分段。
错误
- 标准 Sar 错误(见表 15)
- 程序中止:比特数值(
<bit_count>)必须大于 0。 - 程序中止:缓冲区类型(重组)对该内核过程无效,应为(分段或再分段)。
- 程序中止:超出虚拟内存限制。分配的对象过多。
- 可恢复错误:对象块分配失败 / 对象类型(
<ob_type>)。
参考
- 使用内核过程 op_sar_srcbuf_seg_remove() 从(再)分段缓冲区的头部移除一个 Sar 分段
- 使用内核过程 op_sar_srcbuf_bits_flush() 从(再)分段缓冲区清除由局部比特索引和长度标识的比特范围
- 使用内核过程 op_sar_segbuf_pk_insert() 将源数据包插入分段缓冲区的尾部
- 使用内核过程 op_sar_rsgbuf_seg_insert() 将 Sar 分段插入再分段缓冲区的尾部