op_sar_bitrange_info_get()
摘要
获取关于比特范围的信息,将起始比特编号、比特数量、原始数据包的大小或数据包的标签写入一个变量。
语法
op_sar_bitrange_info_get (bit_range, property, dest)
| 参数 | 类型 | 说明 |
|---|---|---|
bit_range |
Sar_Bitrange* |
要查询的比特范围 |
property |
int |
比特范围中需要关注的项。可能的值见详情。 |
dest |
int * 或 OpT_Sar_Size * |
接收所查询组成部分值的变量 |
返回类型
Compcode
完成代码,指示该属性是否成功获取。
[该值可与两个符号常量 OPC_COMPCODE_SUCCESS 和 OPC_COMPCODE_FAILURE 进行比较。]
示例
/* obtain the label associated with a bitrange and */
/* encode it as an integer value in an unused packet field. */
bitrange_ptr = (Sar_Bitrange *) op_prg_list_access (bitrange_list_ptr,
OPC_LISTPOS_HEAD);
op_sar_bitrange_info_get (bitrange_ptr, OPC_SAR_BITRANGE_PROPERTY_LABEL,
&label_value);
/* encode the label in packet field. */
op_pk_nfd_set (pkptr, "encoded label", label_value);
/* send packet down to lower layer. */
op_pk_send (pkptr, 0);
详情
比特范围包含四个可由该内核过程查询的属性。起始比特是首比特在原始数据包中的位置。比特范围中的比特数量、原始数据包大小和原始数据包标签也可以获取。
property 参数可以取以下值:
OPC_SAR_BITRANGE_PROPERTY_COUNT(dest为 int)OPC_SAR_BITRANGE_PROPERTY_COUNT_INT64(dest为 OpT_Int64)OPC_SAR_BITRANGE_PROPERTY_STARTBIT(dest为 int)OPC_SAR_BITRANGE_PROPERTY_STARTBIT_INT64(dest为 OpT_Int64)OPC_SAR_BITRANGE_PROPERTY_LABEL(dest为 int)OPC_SAR_BITRANGE_PROPERTY_LABEL_INT64(dest为 OpT_Int64)OPC_SAR_BITRANGE_PROPERTY_PKSIZE(dest为 int)OPC_SAR_BITRANGE_PROPERTY_PKSIZE_INT64(dest为 OpT_Int64)
用途
提供一种获取比特范围信息的机制。
错误
- 可恢复错误:比特范围无效。
- 可恢复错误:比特范围属性无效。
参考
- 使用内核过程 op_sar_bitrange_create() 创建新的比特范围
- 使用内核过程 op_sar_bitrange_destroy() 释放与比特范围关联的内存
- 使用内核过程 op_sar_seg_bitrange_list_get() 获取分段内的比特范围列表