op_sar_rsgbuf_bits_flush_abs()
摘要
从指定再分段缓冲区中清除指定的绝对比特范围。
语法
op_sar_rsgbuf_bits_flush_abs (sb_hndl, bit_index_abs, bit_count)
| 参数 | 类型 | 说明 |
|---|---|---|
sb_hndl |
Sbhandle |
标识目标再分段缓冲区的句柄 [该值必须标识一个 Sar 再分段缓冲区。Sar 缓冲区句柄在通过内核过程 op_sar_buf_create() 创建缓冲区时获得。] |
bit_index_abs |
OpT_Sar_Size |
要从缓冲区清除的范围中首个比特的绝对索引 [绝对索引是一种数字值,基于用户定义的编号系统标识 Sar 缓冲区中某个范围的首个比特。再分段缓冲区中每个分段首个比特的绝对索引在插入时由内核过程 op_sar_rsgbuf_seg_insert() 设置] |
bit_count |
OpT_Sar_Size |
要从缓冲区清除的范围中的比特数 [该值指定要清除的比特范围的长度。] |
返回类型
Compcode
完成代码,指示指定比特是否成功清除。
[该值可与两个符号常量 OPC_COMPCODE_SUCCESS 和 OPC_COMPCODE_FAILURE 进行比较。]
示例
/* Receive an acknowledgment from the peer process. */
ack_pkptr = op_pk_get (ACK_INSTRM);
/* Determine the sequence number of the last byte being acknowledged. */
op_pk_nfd_get (ack_pkptr, "seq_num", &new_ack_last_byte);
/* Check if new acknowledgment progressed past last acknowledgment. */
if (new_ack_last_byte > old_ack_last_byte)
{
/* Determine the bit-range of new acknowledgment. */
new_ack_bit_index = (old_ack_last_byte + 1) * 8;
new_ack_bit_count = (new_ack_last_byte - old_ack_last_byte) * 8;
/* Flush the resegmentation buffer of acknowledged bits. */
op_sar_rsgbuf_bits_flush_abs (rsg_sbh, new_ack_bit_index, new_ack_bit_count);
/* Reset new acknowledgment as old acknowledgment. */
old_ack_last_byte = new_ack_last_byte;
}
详情
从再分段缓冲区清除一段比特会将其永久移出缓冲区所存储比特的序列。如果被清除的比特范围不在缓冲区头部,缓冲区剩余比特在被清除的比特范围所在位置将出现“顺序跳跃”。如果指定比特范围包含缓冲区中与某个特定分段或源数据包关联的全部比特,则该分段或源数据包关联也将一并从缓冲区中清除。如果指定比特范围仅包含缓冲区中与某个特定分段或源数据包关联的部分比特,则该分段或源数据包关联将因被清除的部分而缩减。
bit_index_abs 与 bit_count 两个参数均为 64 位整数,以容纳大范围。
用途
提供一种从再分段缓冲区清除一段比特的机制,该范围由范围中首个比特的绝对索引标识。从再分段缓冲区清除比特范围通常在这些缓冲区用于重传目的时进行(即存储已传输数据的副本,以便在数据包丢失、过度延迟等情况下可能重传)。在这种情况下,当一段已传输的数据被正确接收后,就可以从再分段缓冲区中清除,因为它不再需要作为传输失败的“保险”(这种用法的示例见示例小节)。当被清除的数据可能跨越分段与源数据包边界时,按比特范围清除数据非常有用。
错误
- 标准 Sar 错误(见表 15)
- 程序中止:缓冲区句柄引用了已销毁的缓冲区。
- 程序中止:缓冲区类型(
<type>)对该内核过程无效,应为(再分段)。 - 程序中止:数据包(
<pkid>)必须是另一个数据包的分段。 - 程序中止:比特数(
<bit_count>)必须大于 0。 - 可恢复错误:索引(
<bit_index_abs>)无效。 / 值必须大于或等于 0。
参考
- 使用内核过程 op_sar_srcbuf_bits_flush() 从(再)分段缓冲区清除由局部比特索引和长度标识的比特范围
- 使用内核过程 op_sar_rsgbuf_lbl_pk_range_get() 确定再分段缓冲区中与特定源数据包关联的比特范围的局部比特索引和长度
- 使用内核过程 op_sar_rsgbuf_lbl_seg_range_get() 确定再分段缓冲区中与特定 Sar 分段关联的比特范围的局部比特索引和长度
- 使用内核过程 op_sar_buf_size() 确定 Sar 缓冲区中存储的比特数