oms_wp_phy_pk_transmission_info_get()
摘要
获取给定数据包的无线传输属性。
语法
oms_wp_phy_pk_transmission_info_get (Packet *pkptr, attr_id_0, attr_0_ptr, attr_id_1, attr_1_ptr, . end_of_arguments_id);
| 参数 | 类型 | 说明 |
|---|---|---|
Pkptr |
packet* |
需要从中获取无线信息的数据包。 |
attr_id_<num> |
int |
必须使用表 12 给出的预定义属性 ID 常量。 本函数说明末尾的表格给出了属性 ID 常量的完整列表及其说明。 |
attr_<num>_ptr |
变量指针类型 | 指向某个变量的指针,该变量将被填入指定属性的值。指针类型必须与对应属性 ID 的要求匹配。 |
end_of_arguments_id |
int |
始终使用 OMSC_WP_ARG_END |
返回类型
Compcode
若属性成功获取,返回 OPC_COMPCODE_SUCCESS;否则返回 OPC_COMPCODE_FAILURE。
详细说明
Advanced Wireless Package 的客户端模块(例如 MAC 模块)在需要获取从 PHY 层收到的数据包的特定无线属性时,可以使用该内核过程。
该函数在数据包中设置的属性数量是可变的。每个属性由一对相邻参数设置:每对的第一个参数是表示待获取属性的常量,其后是指向某块内存位置的指针,该属性的值将被写入此处。
所需属性列表写完后,必须传入特殊常量 OMSC_WP_ARG_END,表示属性列表结束。
表 12:attr_id_<num> 参数的取值
| 符号常量 | 对应值类型 | 说明 |
|---|---|---|
| OMSC_WP_PK_MIMO_TECHNIQUE_INT | OmsT_WP_MIMO_Tx_Technique* |
指向某块内存位置的指针,用于存放该数据包的 MIMO 传输技术。 更多信息见 OmsT_WP_MIMO_Tx_Technique。 |
| OMSC_WP_PK_CODEWORD_INDEX_INT | OmsT_WP_Codeword_Index* |
指向某块内存位置的指针,用于存放该数据包的码字索引。 更多信息见 OmsT_WP_Codeword_Index。 |
示例
lte_ue_as 进程模型函数块的节选
/* Get the codeword index from the PHY info in the packet. */
oms_wp_phy_pk_transmission_info_get (mpdu_pkptr,
OMSC_WP_PK_CODEWORD_INDEX_INT, &wp_codeword_index,
OMSC_WP_ARG_END);