op_sar_rsgbuf_lbl_pk_range_get()
摘要
获取指定再分段缓冲区中由标签标识的源数据包的比特范围参数。
语法
op_sar_rsgbuf_lbl_pk_range_get (sb_hndl, label, first_bit_ptr, num_bits_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
sb_hndl |
Sbhandle |
标识目标再分段缓冲区的句柄 [该值必须标识一个 Sar 再分段缓冲区。Sar 缓冲区句柄在通过内核过程 op_sar_buf_create() 创建缓冲区时获得。] |
label |
OpT_Int64 |
标识缓冲区中源数据包的标签 [数据包标签是一种用户定义的数值,用于标识 Sar 缓冲区中的特定数据包。源数据包在通过 op_sar_segbuf_pk_insert() 插入 Sar 分段缓冲区时被赋予标签。] |
first_bit_ptr |
OpT_Sar_Size* |
指向一个变量的指针,该变量被赋值为缓冲区中与指定源数据包关联的首个比特的局部索引 [局部索引是一种数字值,指示 Sar 缓冲区中指定比特范围内首个比特的位置(此处为该源数据包关联的范围)。局部索引取值从 0(缓冲区中的首个比特)到 N-1(缓冲区中的最后一个比特,N 为缓冲区中的比特数)。] |
num_bits_ptr |
OpT_Sar_Size* |
指向一个变量的指针,该变量被赋值为缓冲区中与指定数据包关联的比特数 |
返回类型
Compcode
完成代码,指示指定源数据包的剩余内容是否以单个连续比特范围的形式位于缓冲区中,从而为比特索引和计数参数提供有效值。
[该值可与两个符号常量 OPC_COMPCODE_SUCCESS 和 OPC_COMPCODE_FAILURE 进行比较。]
示例
/* Receive an acknowledgement from the peer process. */
ack_pkptr = op_pk_get (ACK_INSTRM);
/* Determine the sequence number of the source packet being acknowledged. */
op_pk_nfd_get (ack_pkptr, "ack_pk_seqnum", &new_ack_pk_seqnum);
/* Check if new acknowledgment progressed past last acknowledgment. */
if (new_ack_pk_seqnum > old_ack_pk_seqnum)
{
/* Determine the buffer-local bit-range of new acknowledgment. */
op_sar_rsgbuf_lbl_pk_range_get (rsg_sbh, new_ack_pk_seqnum,
&new_ack_bit_index, &new_ack_bit_count);
/* Flush the resegmentation buffer of acknowledged bits. */
op_sar_srcbuf_bits_flush (rsg_sbh, new_ack_bit_index, new_ack_bit_count);
/* Reset new acknowledgement as old acknowledgement. */
old_ack_pk_seqnum = new_ack_pk_seqnum;
}
详情
用于向该内核过程标识源数据包的数字标签,必须与该源数据包插入 Sar 分段缓冲区时由内核过程 op_sar_segbuf_pk_insert() 赋予的标签一致。即使源数据包可能已被原始分段缓冲区划分为多个分段、在各模块之间以及链路之间传输,随后又在再分段缓冲区中被部分重新组合,Sar 软件包仍会跟踪再分段缓冲区中与源数据包及其对应标签关联的比特范围。源数据包标签由用户定义,以支持使用进程模型专用的序列号作为标签;通常,源数据包要么以数据包序列号作为标签,要么以其包含的首个(或最后一个)字节(或比特)对应的序列号作为标签。
first_bit_ptr 与 num_bits_ptr 两个参数均为指向 64 位整数的指针,以容纳大范围。
用途
提供一种获取再分段缓冲区中与特定源数据包关联的比特范围的局部比特索引和长度的机制。这些比特范围参数是通过内核过程 op_sar_srcbuf_bits_flush() 将源数据包从再分段缓冲区中清除所必需的。从再分段缓冲区清除源数据包通常在这些缓冲区用于重传目的时进行(即存储已传输数据的副本,以便在数据包丢失、过度延迟等情况下可能重传)。例如,当某个源数据包已被正确接收后,就可以从再分段缓冲区中清除,因为它不再需要作为传输失败的“保险”(这种用法的示例见示例小节)。
错误
- 标准 Sar 错误(见表 15)
- 程序中止:缓冲区句柄引用了已销毁的缓冲区。
- 程序中止:缓冲区类型(
<type>)对该内核过程无效,应为(再分段)。
参考
- 使用内核过程 op_sar_rsgbuf_lbl_seg_range_get() 确定再分段缓冲区中与特定 Sar 分段关联的比特范围的局部比特索引和长度
- 使用内核过程 op_sar_srcbuf_bits_flush() 从(再)分段缓冲区清除由局部比特索引和长度标识的比特范围
- 使用内核过程 op_sar_rsgbuf_bits_flush_abs() 从再分段缓冲区清除由绝对比特索引和长度标识的比特范围