MB 基站信息查询支持
概述
基站信息查询接口用于为基于位置的服务提供手机网络基站信息,如基站 ID、时间提前量和其他可用于计算移动用户地理位置的参数。 所收集的信息与当前为订阅者提供服务的手机网络基站以及邻近手机网络基站有关。
本主题定义了 Windows 的基站信息查询接口,因为 MBIM 1.0 规范并未通过任何现有 CID 提供此类信息。 此接口在 Windows 10 版本 1709 及更高版本中可用。
服务和邻近手机网络参数通过查询/响应操作进行检索。 本主题还定义了一个通知,用于指示设备在手机网络中的位置已发生变化。
MBIM_CID_BASE_STATIONS_INFO
此命令可检索调制解调器已知服务和邻近手机网络的相关信息。
服务:MBB_UUID_BASIC_CONNECT_EXTENSIONS
服务 UUID:3d01dcc5-fef5-4d05-0d3a-bef7058e9aaf
CID | 命令代码 | 最低操作系统版本 |
---|---|---|
MBIM_CID_BASE_STATIONS_INFO | 11 | Windows 10 版本 1709 |
参数
类型 | 设置 | 查询 | 通知 |
---|---|---|---|
命令 | 不适用 | MBIM_BASE_STATIONS_INFO_REQ | 不适用 |
响应 | 不适用 | MBIM_BASE_STATIONS_INFO | 不适用 |
查询
MBIM_COMMAND_MSG 的 InformationBuffer 包含一个 MBIM_BASE_STATIONS_INFO_REQ 结构。 MBIM_COMMAND_DONE 的 InformationBuffer 包含一个 MBIM_BASE_STATIONS_INFO 结构。
MBIM_BASE_STATIONS_INFO_REQ
MBIM_BASE_STATIONS_INFO_REQ 结构应在 InformationBuffer 中用于查询。 它用于配置手机网络信息的各个方面,如作为响应发送的最大邻近手机网络测量次数。
Offset | 大小 | 字段 | 类型 | 描述 |
---|---|---|---|---|
0 | 4 | MaxGSMCount | SIZE | MBIM_GSM_NMR 的 GSM 网络测量报告中返回的 GSM 邻近手机网络条目的最大数量。 默认容量是 15。 |
4 | 4 | MaxUMTSCount | SIZE | 在 MBIM_UMTS_MRL 中的 UMTS 测量结果列表中返回的 UMTS 邻近手机网络的最大条目数。 默认容量是 15。 |
8 | 4 | MaxTDSCDMACount | SIZE | 在 MBIM_TDSCDMA_MRL 中的 TDSCDMA 测量结果列表中返回的 TDSCDMA 邻近手机网络的最大条目数。 默认容量是 15。 |
12 | 4 | MaxLTECount | SIZE | 在 MBIM_LTE_MRL 的 LTE 测量结果列表中返回的 LTE 邻近手机网络条目的最大数量。 默认容量是 15。 |
16 | 4 | MaxCDMACount | SIZE | MBIM_CDMA_MRL 中 CDMA 测量结果列表中返回的 CDMA 手机网络的最大条目数。 此列表包括服务手机网络和邻近手机网络。 默认容量是 12。 |
设置
不适用。
响应
MBIM_BASE_STATIONS_INFO 结构应在 MBIM_COMMAND_DONE 的 InformationBuffer 中用于响应。
MBIM_BASE_STATIONS_INFO
MBIM_BASE_STATIONS_INFO 结构包含服务和邻近基站的信息。
Offset | 大小 | 字段 | 类型 | 描述 |
---|---|---|---|---|
0 | 4 | SystemType | MBIM_DATA_CLASS | 表示服务手机网络信息有效的系统类型(或类型)。 此成员是 MBIM_DATA_CLASS 中定义的一个或多个系统类型的位掩码。 |
4 | 4 | GSMServingCellOffset | OFFSET | 从此结构的开头计算到包含 GSM 服务手机网络信息的缓冲区的偏移量(以字节为单位)。 当服务手机网络采用的技术并非 GSM 时,此成员可以是 NULL。 |
8 | 4 | GSMServingCellSize | SIZE(0-44) | 用于 MBIM_GSM_SERVING_CELL_INFO 的大小(以字节为单位)。 |
12 | 4 | UMTSServingCellOffset | OFFSET | 从此结构的开头计算到包含 UMTS 服务手机网络信息的缓冲区的偏移量(以字节为单位)。 当服务手机网络采用的技术并非 UMTS 时,此成员可以是 NULL。 |
16 | 4 | UMTSServingCellSize | SIZE(0-60) | 用于 MBIM_UMTS_SERVING_CELL_INFO 的大小(以字节为单位)。 |
20 | 4 | TDSCDMAServingCellOffset | OFFSET | 从此结构的开头计算到包含 TDSCDMA 服务手机网络信息的缓冲区的偏移量(以字节为单位)。 当服务手机网络采用的技术并非 TDSCDMA 时,此成员可以是 NULL。 |
24 | 4 | TDSCDMAServingCellSize | SIZE(0-48) | 用于 MBIM_TDSCDMA_SERVING_CELL_INFO 的大小(以字节为单位)。 |
28 | 4 | LTEServingCellOffset | OFFSET | 从此结构的开头计算到包含 LTE 服务手机网络信息的缓冲区的偏移量(以字节为单位)。 当服务手机网络采用的技术并非 LTE 时,此成员可以是 NULL。 |
32 | 4 | LTEServingCellSize | SIZE(0-48) | 用于 MBIM_LTE_SERVING_CELL_INFO 的大小(以字节为单位)。 |
36 | 4 | GSMNmrOffset | OFFSET | 从此结构的开头计算到包含 GSM 网络测量报告的缓冲区的偏移量(以字节为单位)。 当测量报告中没有返回 GSM 邻近网络时,该成员可以为 NULL。 |
40 | 4 | GSMNmrSize | SIZE | 包含格式为 MBIM_GSM_NMR 的 GSM 网络测量报告的缓冲区的总大小(以字节为单位)。 |
44 | 4 | UMTSMrlOffset | OFFSET | 以字节为单位的偏移量,从本结构的开头计算到包含 UMTS 测量结果列表的缓冲区。 当测量报告中没有返回 UMTS 邻近网络时,该成员可以为 NULL。 |
48 | 4 | UMTSMrlSize | SIZE | 包含 UMTS 测量结果列表的缓冲区的总大小(以字节为单位),格式为 MBIM_UMTS_MRL。 |
52 | 4 | TDSCDMAMrlOffset | OFFSET | 以字节为单位的偏移量,从本结构的开头计算到包含 TDSCDMA 测量结果列表的缓冲区。 当测量报告中没有返回 TDSCDMA 邻近网络时,该成员可以为 NULL。 |
56 | 4 | TDSCDMAMrlSize | SIZE | 包含 TDSCDMA 测量结果列表的缓冲区的总大小(以字节为单位),格式为 MBIM_TDSCDMA_MRL。 |
60 | 4 | LTEMrlOffset | OFFSET | 以字节为单位的偏移量,从本结构的开头计算到包含 LTE 测量结果列表的缓冲区。 当测量报告中没有返回 LTE 邻近网络时,该成员可以为 NULL。 |
64 | 4 | LTEMrlSize | SIZE | 包含 LTE 测量结果列表的缓冲区的总大小(以字节为单位),格式为 MBIM_LTE_MRL。 |
68 | 4 | CDMAMrlOffset | OFFSET | 以字节为单位的偏移量,从本结构的开头计算到包含 CDMA 测量结果列表的缓冲区。 当测量报告中没有返回 CDMA 邻近网络时,该成员可以为 NULL。 |
72 | 4 | CDMAMrlSize | SIZE | 包含 CDMA 测量结果列表的缓冲区的总大小(以字节为单位),格式为 MBIM_CDMA_MRL。 |
76 | DataBuffer | DATABUFFER | 包含 GSMServingCell、UMTSServingCell、TDSCDMAServingCell、LTEServingCell、GSMNmr、UMTSMrl、TDSCDMAMrl、LTEMrl 和 CDMAMrl 的数据缓冲区。 |
GSM 手机网络数据结构
MBIM_GSM_SERVING_CELL_INFO
MBIM_GSM_SERVING_CELL_INFO 结构包含有关 GSM 服务手机网络的信息。
Offset | 大小 | 字段 | 类型 | 描述 |
---|---|---|---|---|
0 | 4 | ProviderIdOffset | OFFSET | 以字节为单位的偏移量,从该结构的开头计算到一个名为 ProviderId 的数字(0-9)字符串,该字符串代表网络提供商标识。 此字符串由三位移动国家/地区代码 (MCC) 和两位或三位移动网络代码 (MNC) 组成。 当没有返回 ProviderId 信息时,该成员可以为 NULL。 |
4 | 4 | ProviderIdSize | SIZE(0-12) | 用于 ProviderId 的大小。 |
8 | 4 | LocationAreaCode | UINT32 | 位置区域代码 (0-65535)。 如果没有此信息,请使用 0xFFFFFFFF。 |
12 | 4 | CellID | UINT32 | 手机网络 ID (0-65535)。 如果没有此信息,请使用 0xFFFFFFFF。 |
16 | 4 | TimingAdvance | UINT32 | 定时提前量 (0-255),单位为位周期,位周期为 48/13µs。 如果没有此信息,请使用 0xFFFFFFFF。 |
20 | 4 | ARFCN | UINT32 | 服务手机网络的绝对无线电频率信道编号 (0-1023)。 如果没有此信息,请使用 0xFFFFFFFF。 |
24 | 4 | BaseStationId | UINT32 | 基站 ID - 基站颜色代码和网络标识代码。 如果没有此信息,请使用 0xFFFFFFFF。 |
28 | 4 | RxLevel | UINT32 | 服务手机网络的接收信号强度 (0-63),其中
|
32 | DataBuffer | DATABUFFER | 包含 ProviderId 的数据缓冲区。 |
MBIM_GSM_NMR
MBIM_GSM_NMR 结构包含邻近 GSM 手机网络的网络测量报告 (NMR)。
Offset | 大小 | 字段 | 类型 | 描述 |
---|---|---|---|---|
0 | 4 | ElementCount (EC) | UINT32 | 此元素之后的 NMR 条目计数。 |
4 | DataBuffer | DATABUFFER | NMR 记录数组,每条记录都指定为 MBIM_GSM_NMR_INFO 结构。 |
MBIM_GSM_NMR_INFO
MBIM_GSM_NMR_INFO 结构包含邻近 GSM 手机网络的信息。
Offset | 大小 | 字段 | 类型 | 描述 |
---|---|---|---|---|
0 | 4 | ProviderIdOffset | OFFSET | 以字节为单位的偏移量,从该结构的开头计算到一个名为 ProviderId 的数字(0-9)字符串,该字符串代表网络提供商标识。 此字符串由三位移动国家/地区代码 (MCC) 和两位或三位移动网络代码 (MNC) 组成。 当没有返回 ProviderId 信息时,该成员可以为 NULL。 |
4 | 4 | ProviderIdSize | SIZE(0-12) | 用于 ProviderId 的大小。 |
8 | 4 | LocationAreaCode | UINT32 | 位置区域代码 (0-65535)。 如果没有此信息,请使用 0xFFFFFFFF。 |
12 | 4 | CellID | UINT32 | 手机网络 ID (0-65535)。 如果没有此信息,请使用 0xFFFFFFFF。 |
16 | 4 | ARFCN | UINT32 | 服务手机网络的绝对无线电频率信道编号 (0-1023)。 如果没有此信息,请使用 0xFFFFFFFF。 |
20 | 4 | BaseStationId | UINT32 | 服务手机网络的无线基站 ID (0-63)。 如果没有此信息,请使用 0xFFFFFFFF。 |
24 | 4 | RxLevel | UINT32 | 服务手机网络的接收信号强度 (0-63),其中
|
28 | DataBuffer | DATABUFFER | 包含 ProviderId 的数据缓冲区。 |
UMTS 手机网络数据结构
MBIM_UMTS_SERVING_CELL_INFO
MBIM_UMTS_SERVING_CELL_INFO 结构包含有关 UMTS 服务手机网络的信息。
Offset | 大小 | 字段 | 类型 | 描述 |
---|---|---|---|---|
0 | 4 | ProviderIdOffset | OFFSET | 以字节为单位的偏移量,从该结构的开头计算到一个名为 ProviderId 的数字(0-9)字符串,该字符串代表网络提供商标识。 此字符串由三位移动国家/地区代码 (MCC) 和两位或三位移动网络代码 (MNC) 组成。 当没有返回 ProviderId 信息时,该成员可以为 NULL。 |
4 | 4 | ProviderIdSize | SIZE(0-12) | 用于 ProviderId 的大小。 |
8 | 4 | LocationAreaCode | UINT32 | 位置区域代码 (0-65535)。 如果没有此信息,请使用 0xFFFFFFFF。 |
12 | 4 | CellID | UINT32 | 手机网络 ID (0-268435455)。 如果没有此信息,请使用 0xFFFFFFFF。 |
16 | 4 | FrequencyInfoUL | UINT32 | 频率信息上行链路 (0-16383)。 如果没有此信息,请使用 0xFFFFFFFF。 |
20 | 4 | FrequencyInfoDL | UINT32 | 频率信息下行链路 (0-16383)。 如果没有此信息,请使用 0xFFFFFFFF。 |
24 | 4 | FrequencyInfoNT | UINT32 | TDD 的频率信息 (0-16383)。 如果没有此信息,请使用 0xFFFFFFFF。 |
28 | 4 | UARFCN | UINT32 | 服务手机网络的 UTRA 绝对无线电频率信道编号 (0-16383)。 如果没有此信息,请使用 0xFFFFFFFF。 |
32 | 4 | PrimaryScramblingCode | UINT32 | 服务手机网络的主扰码 (0-511)。 如果没有此信息,请使用 0xFFFFFFFF。 |
36 | 4 | RSCP | INT32 | 服务手机网络的接收信号编码功率。 范围为 -120 至 -25,单位为 1dBm。 如果没有此信息,请使用 0。 |
40 | 4 | ECNO | INT32 | 服务手机网络的信噪比;CPICH 每个 PN 芯片的接收能量与总接收能量之比。 范围为 -50 至 0,单位为 1dBm。 如果没有此信息,请使用 1。 |
44 | 4 | PathLoss | UINT32 | 服务手机网络的路径损耗 (46-173)。 如果没有此信息,请使用 0xFFFFFFFF。 |
48 | DataBuffer | DATABUFFER | 包含 ProviderId 的数据缓冲区。 |
MBIM_UMTS_MRL
MBIM_UMTS_MRL 结构包含邻近 UMTS 手机网络的测量结果列表 (MRL)。
Offset | 大小 | 字段 | 类型 | 描述 |
---|---|---|---|---|
0 | 4 | ElementCount (EC) | UINT32 | 此元素之后的 MRL 条目计数。 |
4 | DataBuffer | DATABUFFER | MRL 记录数组,每条记录都指定为 MBIM_UMTS_MRL_INFO 结构。 |
MBIM_UMTS_MRL_INFO
MBIM_UMTS_MRL_INFO 结构包含邻近 UMTS 手机网络的信息。
Offset | 大小 | 字段 | 类型 | 描述 |
---|---|---|---|---|
0 | 4 | ProviderIdOffset | OFFSET | 以字节为单位的偏移量,从该结构的开头计算到一个名为 ProviderId 的数字(0-9)字符串,该字符串代表网络提供商标识。 此字符串由三位移动国家/地区代码 (MCC) 和两位或三位移动网络代码 (MNC) 组成。 当没有返回 ProviderId 信息时,该成员可以为 NULL。 |
4 | 4 | ProviderIdSize | SIZE(0-12) | 用于 ProviderId 的大小。 |
8 | 4 | LocationAreaCode | UINT32 | 位置区域代码 (0-65535)。 如果没有此信息,请使用 0xFFFFFFFF。 |
12 | 4 | CellID | UINT32 | 手机网络 ID (0-268435455)。 如果没有此信息,请使用 0xFFFFFFFF。 |
16 | 4 | UARFCN | UINT32 | 服务手机网络的 UTRA 绝对无线电频率信道编号 (0-16383)。 如果没有此信息,请使用 0xFFFFFFFF。 |
20 | 4 | PrimaryScramblingCode | UINT32 | 服务手机网络的主扰码 (0-511)。 如果没有此信息,请使用 0xFFFFFFFF。 |
24 | 4 | RSCP | INT32 | 服务手机网络的接收信号编码功率。 范围为 -120 至 -25,单位为 1dBm。 如果没有此信息,请使用 0。 |
28 | 4 | ECNO | INT32 | 服务手机网络的信噪比;CPICH 每个 PN 芯片的接收能量与总接收能量之比。 范围为 -50 至 0,单位为 1dBm。 如果没有此信息,请使用 1。 |
32 | 4 | PathLoss | UINT32 | 服务手机网络的路径损耗 (46-173)。 如果没有此信息,请使用 0xFFFFFFFF。 |
36 | DataBuffer | DATABUFFER | 包含 ProviderId 的数据缓冲区。 |
TDSCDMA 手机网络数据结构
MBIM_TDSCDMA_SERVING_CELL_INFO
MBIM_TDSCDMA_SERVING_CELL_INFO 结构包含有关 TDSCDMA 服务手机网络的信息。
Offset | 大小 | 字段 | 类型 | 描述 |
---|---|---|---|---|
0 | 4 | ProviderIdOffset | OFFSET | 以字节为单位的偏移量,从该结构的开头计算到一个名为 ProviderId 的数字(0-9)字符串,该字符串代表网络提供商标识。 此字符串由三位移动国家/地区代码 (MCC) 和两位或三位移动网络代码 (MNC) 组成。 当没有返回 ProviderId 信息时,该成员可以为 NULL。 |
4 | 4 | ProviderIdSize | SIZE(0-12) | 用于 ProviderId 的大小。 |
8 | 4 | LocationAreaCode | UINT32 | 位置区域代码 (0-65535)。 如果没有此信息,请使用 0xFFFFFFFF。 |
12 | 4 | CellID | UINT32 | 手机网络 ID (0-268435455)。 如果没有此信息,请使用 0xFFFFFFFF。 |
16 | 4 | UARFCN | UINT32 | 服务手机网络的 UTRA 绝对无线电频率信道编号 (0-16383)。 如果没有此信息,请使用 0xFFFFFFFF。 |
20 | 4 | CellParameterID | UINT32 | 手机网络参数 ID (0-127)。 如果没有此信息,请使用 0xFFFFFFFF。 |
24 | 4 | TimingAdvance | UINT32 | 定时提前量 (0-1023)。 该成员在所有时段的值相同。 如果没有此信息,请使用 0xFFFFFFFF。 |
28 | 4 | RSCP | INT32 | 服务手机网络的接收信号编码功率。 范围为 -120 至 -25,单位为 1dBm(Q8 L3 滤波)。 如果没有此信息,请使用 0xFFFFFFFF。 |
32 | 4 | PathLoss | UINT32 | 服务手机网络的路径损耗 (46-158)。 如果没有此信息,请使用 0xFFFFFFFF。 |
36 | DataBuffer | DATABUFFER | 包含 ProviderId 的数据缓冲区。 |
MBIM_TDSCDMA_MRL
MBIM_TDSCDMA_MRL 结构包含邻近 TDSCDMA 手机网络的测量结果列表 (MRL)。
Offset | 大小 | 字段 | 类型 | 描述 |
---|---|---|---|---|
0 | 4 | ElementCount (EC) | UINT32 | 此元素之后的 MRL 条目计数。 |
4 | DataBuffer | DATABUFFER | MRL 记录数组,每条记录都指定为 MBIM_TDSCDMA_MRL_INFO 结构。 |
MBIM_TDSCDMA_MRL_INFO
MBIM_TDSCDMA_MRL_INFO 结构包含邻近 TDSCDMA 手机网络的信息。
Offset | 大小 | 字段 | 类型 | 描述 |
---|---|---|---|---|
0 | 4 | ProviderIdOffset | OFFSET | 以字节为单位的偏移量,从该结构的开头计算到一个名为 ProviderId 的数字(0-9)字符串,该字符串代表网络提供商标识。 此字符串由三位移动国家/地区代码 (MCC) 和两位或三位移动网络代码 (MNC) 组成。 当没有返回 ProviderId 信息时,该成员可以为 NULL。 |
4 | 4 | ProviderIdSize | SIZE(0-12) | 用于 ProviderId 的大小。 |
8 | 4 | LocationAreaCode | UINT32 | 位置区域代码 (0-65535)。 如果没有此信息,请使用 0xFFFFFFFF。 |
12 | 4 | CellID | UINT32 | 手机网络 ID (0-268435455)。 如果没有此信息,请使用 0xFFFFFFFF。 |
16 | 4 | UARFCN | UINT32 | 服务手机网络的 UTRA 绝对无线电频率信道编号 (0-16383)。 如果没有此信息,请使用 0xFFFFFFFF。 |
20 | 4 | CellParameterID | UINT32 | 手机网络参数 ID (0-127)。 如果没有此信息,请使用 0xFFFFFFFF。 |
24 | 4 | TimingAdvance | UINT32 | 定时提前量 (0-1023)。 该成员在所有时段的值相同。 如果没有此信息,请使用 0xFFFFFFFF。 |
28 | 4 | RSCP | INT32 | 服务手机网络的接收信号编码功率。 范围为 -120 至 -25,单位为 1dBm(Q8 L3 滤波)。 如果没有此信息,请使用 0xFFFFFFFF。 |
32 | 4 | PathLoss | UINT32 | 服务手机网络的路径损耗 (46-158)。 如果没有此信息,请使用 0xFFFFFFFF。 |
36 | DataBuffer | DATABUFFER | 包含 ProviderId 的数据缓冲区。 |
LTE 手机网络数据结构
MBIM_LTE_SERVING_CELL_INFO
MBIM_LTE_SERVING_CELL_INFO 结构包含有关 LTE 服务手机网络的信息。
Offset | 大小 | 字段 | 类型 | 描述 |
---|---|---|---|---|
0 | 4 | ProviderIdOffset | OFFSET | 以字节为单位的偏移量,从该结构的开头计算到一个名为 ProviderId 的数字(0-9)字符串,该字符串代表网络提供商标识。 此字符串由三位移动国家/地区代码 (MCC) 和两位或三位移动网络代码 (MNC) 组成。 当没有返回 ProviderId 信息时,该成员可以为 NULL。 |
4 | 4 | ProviderIdSize | SIZE(0-12) | 用于 ProviderId 的大小。 |
8 | 4 | CellID | UINT32 | 手机网络 ID (0-268435455)。 如果没有此信息,请使用 0xFFFFFFFF。 |
12 | 4 | EARFCN | UINT32 | 服务手机网络的无线电频率信道编号 (0-65535)。 如果没有此信息,请使用 0xFFFFFFFF。 |
16 | 4 | PhysicalCellID | UINT32 | 物理手机网络 ID (0-503)。 如果没有此信息,请使用 0xFFFFFFFF。 |
20 | 4 | TAC | UINT32 | 追踪区域代码 (0-65535)。 如果没有此信息,请使用 0xFFFFFFFF。 |
24 | 4 | RSRP | INT32 | 平均参考信号接收功率。 范围为 -140 至 -44,单位为 1dBm。 如果没有此信息,请使用 0xFFFFFFFF。 |
28 | 4 | RSRQ | INT32 | 平均参考信号接收质量。 范围为 -20 至 -3,单位为 1dBm。 如果没有此信息,请使用 0xFFFFFFFF。 |
32 | 4 | TimingAdvance | UINT32 | 定时提前量 (0-255)。 如果没有此信息,请使用 0xFFFFFFFF。 |
36 | DataBuffer | DATABUFFER | 包含 ProviderId 的数据缓冲区。 |
MBIM_LTE_MRL
MBIM_LTE_MRL 结构包含邻近 LTE 手机网络的测量结果列表 (MRL)。
Offset | 大小 | 字段 | 类型 | 描述 |
---|---|---|---|---|
0 | 4 | ElementCount (EC) | UINT32 | 此元素之后的 MRL 条目计数。 |
4 | DataBuffer | DATABUFFER | MRL 记录数组,每条记录都指定为 MBIM_LTE_MRL_INFO 结构。 |
MBIM_LTE_MRL_INFO
MBIM_LTE_MRL_INFO 结构包含邻近 LTE 手机网络的信息。
Offset | 大小 | 字段 | 类型 | 描述 |
---|---|---|---|---|
0 | 4 | ProviderIdOffset | OFFSET | 以字节为单位的偏移量,从该结构的开头计算到一个名为 ProviderId 的数字(0-9)字符串,该字符串代表网络提供商标识。 此字符串由三位移动国家/地区代码 (MCC) 和两位或三位移动网络代码 (MNC) 组成。 当没有返回 ProviderId 信息时,该成员可以为 NULL。 |
4 | 4 | ProviderIdSize | SIZE(0-12) | 用于 ProviderId 的大小。 |
8 | 4 | CellID | UINT32 | 手机网络 ID (0-268435455)。 如果没有此信息,请使用 0xFFFFFFFF。 |
12 | 4 | EARFCN | UINT32 | 服务手机网络的无线电频率信道编号 (0-65535)。 如果没有此信息,请使用 0xFFFFFFFF。 |
16 | 4 | PhysicalCellID | UINT32 | 物理手机网络 ID (0-503)。 如果没有此信息,请使用 0xFFFFFFFF。 |
20 | 4 | TAC | UINT32 | 追踪区域代码 (0-65535)。 如果没有此信息,请使用 0xFFFFFFFF。 |
24 | 4 | RSRP | INT32 | 平均参考信号接收功率。 范围为 -140 至 -44,单位为 1dBm。 如果没有此信息,请使用 0xFFFFFFFF。 |
28 | 4 | RSRQ | INT32 | 平均参考信号接收质量。 范围为 -20 至 -3,单位为 1dBm。 如果没有此信息,请使用 0xFFFFFFFF。 |
32 | DataBuffer | DATABUFFER | 包含 ProviderId 的数据缓冲区。 |
CDMA 手机网络数据结构
MBIM_CDMA_MRL
MBIM_CDMA_MRL 结构包含服务 CDMA 手机网络和邻近 CDMA 手机网络的测量结果列表 (MRL)。
Offset | 大小 | 字段 | 类型 | 描述 |
---|---|---|---|---|
0 | 4 | ElementCount (EC) | UINT32 | 此元素之后的 MRL 条目计数。 |
4 | DataBuffer | DATABUFFER | MRL 记录数组,每条记录都指定为 MBIM_CDMA_MRL_INFO 结构。 |
MBIM_CDMA_MRL_INFO
MBIM_CDMA_MRL_INFO 数据结构专为 CDMA2000 网络类型设计。 可以同时有多个 CDMA2000 服务手机网络。 服务手机网络和邻近手机网络都将在同一列表中返回。 ServiceCellFlag 字段指明手机网络是否为服务手机网络。
Offset | 大小 | 字段 | 类型 | 描述 |
---|---|---|---|---|
0 | 4 | ServingCellFlag | UINT32 | 指明这是否是一个服务手机网络。 数值为 1 表示服务手机网络,数值为 0 表示邻近手机网络。 同一时间可能有多个服务手机网络(尤其是在通话过程中)。 |
4 | 4 | NID | UINT32 | 网络 ID (0-65535)。 如果没有此信息,请使用 0xFFFFFFFF。 |
8 | 4 | SID | UINT32 | 系统 ID (0-32767)。 如果没有此信息,请使用 0xFFFFFFFF。 |
12 | 4 | BaseStationId | UINT32 | 基站 ID (0-65535)。 如果没有此信息,请使用 0xFFFFFFFF。 |
16 | 4 | BaseLatitude | UINT32 | 基站纬度 (0-4194303)。 以 0.25 秒为单位进行编码,用 DWORD 低 22 位的二进制表示。 作为符号值,北纬为正值。 如果没有此信息,请使用 0xFFFFFFFF。 |
20 | 4 | BaseLongitude | UINT32 | 基站经度 (0-8388607)。 以 0.25 秒为单位进行编码,用 DWORD 低 23 位的二进制表示。 作为有符号的值,东经为正值。 如果没有此信息,请使用 0xFFFFFFFF。 |
24 | 4 | RefPN | UINT32 | 基站 PN 号码 (0-511)。 如果没有此信息,请使用 0xFFFFFFFF。 |
28 | 4 | GPSSeconds | UINT32 | GPS 秒,即从基站到达的时间。 如果没有此信息,请使用 0xFFFFFFFF。 |
32 | 4 | PilotStrength | UINT32 | 试点的信号强度 (0-63)。 如果没有此信息,请使用 0xFFFFFFFF。 |
未经请求的事件
不适用。
状态代码
此 CID 使用通用状态代码(请参阅公共 USB MBIM 标准第 9.4.5 节中的状态代码的使用)。
MBIM_CID_LOCATION_INFO_STATUS
此 CID 可检索显示设备位置的手机网络信息状态。 当位置信息发生变化时,它还可用于主动发送通知。
服务:MBB_UUID_BASIC_CONNECT_EXTENSIONS
服务 UUID:3d01dcc5-fef5-4d05-0d3a-bef7058e9aaf
CID | 命令代码 | 最低操作系统版本 |
---|---|---|
MBIM_CID_LOCATION_INFO_STATUS | 12 | Windows 10 版本 1709 |
注意
MBIM_CID_LOCATION_INFO_STATUS 从 Windows 10 版本 1709 开始定义,但目前不受 OS 支持。 调制解调器可以将此命令作为通知发送,但 OS 目前不会处理它。
参数
类型 | 设置 | 查询 | 通知 |
---|---|---|---|
命令 | 不适用 | 不适用 | 不适用 |
响应 | 不适用 | MBIM_LOCATION_INFO | MBIM_LOCATION_INFO |
查询
不使用 MBIM_COMMAND_MSG 的 InformationBuffer。 MBIM_COMMAND_DONE 的 InformationBuffer 包含一个 MBIM_LOCATION_INFO 结构。
设置
不适用。
响应
MBIM_LOCATION_INFO
Offset | 大小 | 字段 | 类型 | 描述 |
---|---|---|---|---|
0 | 4 | LocationAreaCode | UINT32 | 当前位置的 GSM/UMTS 区号。 如果当前系统类型不适用,则返回 0xFFFFFFFF。 |
4 | 4 | TrackingAreaCode | UINT32 | 当前位置的 LTE 跟踪区域代码。 如果当前系统类型不适用,则返回 0xFFFFFFFF。 |
8 | 4 | CellID | UINT32 | 手机信号塔的 ID。 当 CellID 不可用时,返回 0xFFFFFFFF。 |
未经请求的事件
事件 InformationBuffer 包含一个 MBIM_LOCATION_INFO 结构。
如果位置区域代码/追踪区域代码的值更改为有效值,则发送此事件。 当 CellID 发生变化或位置区域代码/追踪区域代码变为无效时,不会发送此事件。
状态代码
此 CID 使用通用状态代码(请参阅公共 USB MBIM 标准第 9.4.5 节中的状态代码的使用)。
OID_WWAN_BASE_STATIONS_INFO
与 MBIM_CID_BASE_STATIONS_INFO 对应的 NDIS 名称是 OID_WWAN_BASE_STATIONS_INFO。