(wwan.h) WWAN_DEVICE_CAPS_EX 结构
重要
无偏差通信
Microsoft 支持多样化且包容的环境。 本文包含 Microsoft 无偏见通信风格指南 识别为排除性的术语的引用。 为了保持一致性，本文使用了单词或短语，因为它当前出现在软件中。 当软件更新为删除语言时，本文将更新为一致。
WWAN_DEVICE_CAPS_EX结构表示移动宽带设备的功能。 WWAN_DEVICE_CAPS_EX通过添加用于跟踪特定执行程序的执行程序 Index 成员和 Microsoft 服务扩展的 WwanOptionalServiceCaps 成员来扩展现有的 WWAN_DEVICE_CAPS 结构。
语法
typedef struct _WWAN_DEVICE_CAPS_EX {
WWAN_DEVICE_TYPE WwanDeviceType;
WWAN_CELLULAR_CLASS WwanCellularClass;
WWAN_VOICE_CLASS WwanVoiceClass;
WWAN_SIM_CLASS WwanSimClass;
ULONG WwanDataClass;
WCHAR CustomDataClass[WWAN_CUSTOM_DATA_CLASS_LEN];
ULONG WwanGsmBandClass;
ULONG WwanCdmaBandClass;
WCHAR CustomBandClass[WWAN_CUSTOM_BAND_CLASS_LEN];
ULONG WwanSmsCaps;
ULONG WwanControlCaps;
WCHAR DeviceId[WWAN_DEVICEID_LEN];
WCHAR Manufacturer[WWAN_MANUFACTURER_LEN];
WCHAR Model[WWAN_MODEL_LEN];
WCHAR FirmwareInfo[WWAN_FIRMWARE_LEN];
ULONG MaxActivatedContexts;
ULONG WwanAuthAlgoCaps;
ULONG ExecutorIndex;
ULONG WwanOptionalServiceCaps;
ULONG WwanSimClassBitMasks;
ULONG WwanWCDMABandClass;
USHORT WwanLTEBandClass[WWAN_MAX_NUM_LTE_BAND];
USHORT WwanNRBandClass[WWAN_MAX_NUM_NR_BAND];
ULONGLONG WwanDataSubClass;
ULONGLONG WwanMiscCaps;
WWAN_LIST_HEADER CellularClassListHeader;
} WWAN_DEVICE_CAPS_EX, *PWWAN_DEVICE_CAPS_EX;
成员
WwanDeviceType
设备的类型。 微型端口驱动程序必须将设备类型设置为 WwanDeviceTypeUnknown 以外的值。
WwanCellularClass
设备的手机网络类。 微型端口驱动程序必须将手机网络类设置为 WwanCellularClassUnknown 以外的值。 此成员中的值控制特定于手机网络技术的功能，例如网络提供商注册模式。
支持多模式的微型端口驱动程序应将此设置为 WwanCellularClassGsm。
WwanVoiceClass
设备的语音类。 此成员告知 MB 服务是否存在线路语音服务，以及此类服务如何与数据服务交互。 请注意，MB 服务本机不支持线路切换语音，也不排除它。 由微型端口驱动程序决定如何支持线路语音。 此 WwanVoiceClass 成员允许 MB 服务在将来支持此功能。
WwanSimClass
订阅服务器标识模块的类 (由WWAN_SIM_CLASS枚举指定的 SIM 卡卡) 。 微型端口驱动程序必须将 SIM 类设置为 WwanSimClassUnknown 以外的值。
WwanDataClass
一个位图，表示设备支持的数据类 (es) 。 下表显示了此成员的可能值。
| 值 | 含义 |
|---|---|
| WWAN_DATA_CLASS_NONE | 设备不支持数据服务。 |
| WWAN_DATA_CLASS_GPRS | 支持常规数据包无线电服务 (GPRS) 数据服务。 此值仅适用于基于 GSM 的设备。 |
| WWAN_DATA_CLASS_EDGE | 支持全球演进 (EDGE) 数据服务的增强数据。 此值仅适用于基于 GSM 的设备。 |
| WWAN_DATA_CLASS_UMTS | 支持通用移动电信系统 (UMTS) 数据服务。 此值仅适用于基于 GSM 的设备。 |
| WWAN_DATA_CLASS_HSDPA | 支持 High-Speed 下行数据包访问 (HSDPA) 数据服务。 此值仅适用于基于 GSM 的设备。 |
| WWAN_DATA_CLASS_HSUPA | 支持 High-Speed 上行数据包访问 (HSUPA) 数据服务。 此值仅适用于基于 GSM 的设备。 |
| WWAN_DATA_CLASS_LTE | 支持 LTE 数据服务。 此值仅适用于基于 GSM 的设备。 |
| WWAN_DATA_CLASS_5G_NSA | 支持非独立 5G 数据服务。 有关 5G 数据类支持的详细信息，请参阅 MB 5G 数据类支持。 |
| WWAN_DATA_CLASS_SA | 支持独立的 5G 数据服务。 有关 5G 数据类支持的详细信息，请参阅 MB 5G 数据类支持。 |
| WWAN_DATA_CLASS_1XRTT | CDMA 1x 无线电传输技术 (1xRTT，也称为 cdma2000，CDMA2000 1x 等) 数据服务受支持。 此值仅适用于基于 CDMA 的设备。 |
| WWAN_DATA_CLASS_1XEVDO | CDMA Evolution-Data 优化 (最初仅支持数据、1xEDVO（也称为 CDMA2000 1x EV-DO）或 1x EVDO) 数据服务。 此值仅适用于基于 CDMA 的设备。 |
| WWAN_DATA_CLASS_1XEVDO_REVA | 支持 1xEVDO RevA 数据服务。 此值仅适用于基于 CDMA 的设备。 |
| WWAN_DATA_CLASS_1XEVDV | 支持 CDMA Evolution-Data/Voice (也称为 CDMA 2000 1x EV-DV 或 1x EVDV) 数据服务。 此值仅适用于基于 CDMA 的设备。 |
| WWAN_DATA_CLASS_3XRTT | 支持 CDMA 3x 无线电传输技术 (3xRTT) 数据服务。 此值仅适用于基于 CDMA 的设备。 |
| WWAN_DATA_CLASS_1XEVDO_REVB | 支持 1xEVDO RevB 数据服务。 此值仅适用于基于 CDMA 的设备。 |
| WWAN_DATA_CLASS_UMB | 支持 UMB 数据服务。 此值仅适用于基于 CDMA 的设备。 |
| WWAN_DATA_CLASS_CUSTOM | 设备支持此表中未列出的数据服务。 |
CustomDataClass[WWAN_CUSTOM_DATA_CLASS_LEN]
一个以 NULL 结尾的字符串，表示自定义数据类的名称。 仅当微型端口驱动程序在 WwanDataClass 成员中设置WWAN_DATA_CLASS_CUSTOM位时，此成员才有效。
WwanGsmBandClass
表示基于 GSM 的设备支持的频带的位图。 下表显示了此成员的可能值。
| 值 | 含义 |
|---|---|
| WWAN_BAND_CLASS_UNKNOWN | 未提供设备支持的频带。 |
| WWAN_BAND_CLASS_I | 设备支持UMTS2100频谱。 |
| WWAN_BAND_CLASS_II | 设备支持UMTS1900频谱。 |
| WWAN_BAND_CLASS_III | 设备支持UMTS1800频谱。 |
| WWAN_BAND_CLASS_IV | 设备支持 AWS 频谱。 |
| WWAN_BAND_CLASS_V | 设备支持UMTS850频谱。 |
| WWAN_BAND_CLASS_VI | 设备支持UMTS800频谱。 |
| WWAN_BAND_CLASS_VII | 设备支持UMTS2600频谱。 |
| WWAN_BAND_CLASS_VIII | 设备支持UMTS900频谱。 |
| WWAN_BAND_CLASS_IX | 设备支持UMTS1700频谱。 |
| WWAN_BAND_CLASS_X | |
| WWAN_BAND_CLASS_CUSTOM | 设备支持除此表中列出的频谱以外的频谱。 |
如果微型端口驱动程序指定WWAN_BAND_CLASS_CUSTOM，则它还应在 CustomBandClass 中提供数据类的名称。
有关这些值的详细信息，请参阅 OID_WWAN_DEVICE_CAPS。
WwanCdmaBandClass
表示基于 CDMA 的设备支持的频带的位图。 下表显示了此成员的可能值。
| 值 | 含义 |
|---|---|
| WWAN_BAND_CLASS_UNKNOWN | 未提供设备支持的频带。 |
| WWAN_BAND_CLASS_0 | 设备支持 800MHz 频带。 |
| WWAN_BAND_CLASS_I | 设备支持 1900MHz 频带。 |
| WWAN_BAND_CLASS_II | 设备支持 TACS 波段。 |
| WWAN_BAND_CLASS_III | 设备支持 JTACS 波段。 |
| WWAN_BAND_CLASS_IV | 设备支持韩国 PCS 波段。 |
| WWAN_BAND_CLASS_V | 设备支持 450 MHz 频带。 |
| WWAN_BAND_CLASS_VI | 设备支持 2 GHz 频带。 |
| WWAN_BAND_CLASS_VII | 设备支持 700 MHz 频带。 |
| WWAN_BAND_CLASS_VIII | 设备支持 1800 MHz 频带。 |
| WWAN_BAND_CLASS_IX | 设备支持 900 MHz 频带。 |
| WWAN_BAND_CLASS_X | 设备支持辅助 800 MHz 频带。 |
| WWAN_BAND_CLASS_XI | 设备支持 400 MHz 欧洲 PAMR 波段。 |
| WWAN_BAND_CLASS_XII | 设备支持 800 MHz PAMR 频带。 |
| WWAN_BAND_CLASS_XIII | 设备支持 2.5GHz IMT2000 扩展频带。 |
| WWAN_BAND_CLASS_XIV | 设备支持美国 PCS 1.9GHz 频带。 |
| WWAN_BAND_CLASS_XV | 设备支持 AWS 频带。 |
| WWAN_BAND_CLASS_XVI | 设备支持美国 2.5GHz 频带。 |
| WWAN_BAND_CLASS_XVII | 设备支持美国 2.5 GHz 仅前向链路带。 |
| WWAN_BAND_CLASS_CUSTOM | 设备支持除此表中列出的带以外的其他波段。 |
如果微型端口驱动程序指定WWAN_BAND_CLASS_CUSTOM，则它还应在 CustomBandClass 中提供数据类的名称。
有关这些值的详细信息，请参阅 OID_WWAN_DEVICE_CAPS。
CustomBandClass[WWAN_CUSTOM_BAND_CLASS_LEN]
一个以 NULL 结尾的字符串，表示自定义带类的名称。 仅当微型端口驱动程序根据需要在 WwanGsmBandClass 或 WwanCdmaBandClass 成员中设置WWAN_BAND_CLASS_CUSTOM位时，此成员才有效。
WwanSmsCaps
表示设备支持的短信类型和方向流的位图。 下表显示了有效的短信功能设置。
| 值 | 含义 |
|---|---|
| WWAN_SMS_CAPS_NONE | 设备不支持短信。 |
| WWAN_SMS_CAPS_PDU_SEND |
对于基于 GSM 的设备，此值表示设备支持发送 PDU 样式的短信。
对于基于 CDMA 的设备，此值意味着设备能够发送二进制格式的短信，如 3GPP2 规范 C.S0015-A“短消息服务 (宽带分散频谱系统的短信) ”部分“3.4.2.1 短信点到点消息”中定义。 |
| WWAN_SMS_CAPS_PDU_RECEIVE |
对于基于 GSM 的设备，此值表示设备支持接收 PDU 样式的短信。
对于基于 CDMA 的设备，此值表示设备能够读取 3GPP2 规范 C.S0015-A“短消息服务 (宽带频谱系统短信) ”部分中定义的二进制格式的短信。 |
| WWAN_SMS_CAPS_TEXT_SEND | 设备支持发送文本样式的短信。 此标志适用于基于 CDMA 的设备。 |
| WWAN_SMS_CAPS_TEXT_RECEIVE | 设备支持接收文本样式的短信。 此标志适用于基于 CDMA 的设备。 |
微型端口驱动程序应设置此成员，以反映仅对 GSM PDU 格式的支持，以便在当前主提供商支持多模式时接收和发送短信。 因此，如果微型端口驱动程序收到手机网络类本机格式的短信，例如 CDMA TEXT 或 CDMA PDU，则需要微型端口驱动程序执行 GSM PDU 转换并将其指示到 MB 服务。 同样，如果微型端口驱动程序收到 GSM PDU 格式的发送请求，则需要将其转换为其本机手机网络类格式。
WwanControlCaps
表示设备支持的控件功能的位图。 下表显示了基于 GSM 和基于 CDMA 的设备的有效 WwanControlCaps 设置。
| 值 | 含义 |
|---|---|
| WWAN_CTRL_CAPS_REG_MANUAL | 指示提供程序网络是否允许手动选择网络。 基于 GSM 的设备微型端口驱动程序应指定此标志。 基于 CDMA 的设备微型端口驱动程序不应指定此标志。 |
| WWAN_CTRL_CAPS_HW_RADIO_SWITCH | 指示存在硬件无线电电源开关。 这对应于 WWAN_DEVICE_TYPE 枚举的 WwanDeviceTypeEmbedded 值。 |
| WWAN_CTRL_CAPS_CDMA_MOBILE_IP |
指示基于 CDMA 的设备配置为支持移动 IP。 此标志仅适用于基于 CDMA 的设备。
当当前主提供程序支持多模式时，微型端口驱动程序不应设置此标志。 |
| WWAN_CTRL_CAPS_CDMA_SIMPLE_IP |
指示基于 CDMA 的设备配置为提供简单的 IP 支持。 此标志仅适用于基于 CDMA 的设备。
当当前主提供程序支持多模式时，微型端口驱动程序不应设置此标志。 |
| 使用 WWAN_CTRL_CAPS_CDMA_SIMPLE_IP 进行WWAN_CTRL_CAPS_CDMA_MOBILE_IP | 指示基于 CDMA 的设备配置为支持移动 IP，使用简单 IP 作为回退选项。 |
| WWAN_CTRL_CAPS_PROTECT_UNIQUEID | 指示 Windows 不应显示国际移动订阅者标识 (IMSI) 。 |
| WWAN_CTRL_CAPS_USSD |
指示基于 GSM 的 MB 设备配置为支持 USSD 协议。 此标志仅适用于基于 GSM 的设备。
支持发送和接收 USSD 消息的微型端口驱动程序设置此标志。 当网络的当前支持多模式的主提供商 GSM 端支持 USSD 时，微型端口驱动程序可以设置此标志，即使网络的 CDMA 端不支持 USSD。 |
| WWAN_CTRL_CAPS_MODEL_MULTI_CARRIER | 指示 MB 设备支持注册和连接到多个网络操作员。 |
| WWAN_CTRL_CAPS_MULTI_MODE | 此标志指示当前家庭提供商支持多个手机网络类/AT (无线电访问技术) 。 |
基于 CDMA 的设备微型端口驱动程序必须指定WWAN_CTRL_CAPS_CDMA_MOBILE_IP或WWAN_CTRL_CAPS_CDMA_SIMPLE_IP，或同时指定这两个标志，以通知 MB 服务设备支持的 IP 类型。
DeviceId[WWAN_DEVICEID_LEN]
以 NULL 结尾的字符串，表示设备 ID。
对于基于 GSM 的设备，字符串必须符合国际移动设备标识 (IMEI) 格式 (最多 15 位) 。
对于基于 CDMA 的设备，字符串必须同时符合电子序列号 (ESN、11 位数字) 和移动设备标识符 (MEID、17 位数字) 格式。
对于支持多模式的微型端口驱动程序，例如在 WwanControlCaps 中设置WWAN_CTRL_CAPS_MULTI_MODE标志的微型端口驱动程序，必须仅报告基于 GSM 的 DeviceId。
此值应存储在设备的内存中，并且即使在 MB 设备/SIM 需要 PIN 才能解锁时也必须可用。
Manufacturer[WWAN_MANUFACTURER_LEN]
以 NULL 结尾的字符串，表示设备制造商。 此成员是可选的。
Model[WWAN_MODEL_LEN]
以 NULL 结尾的字符串，表示设备的型号。 此成员是可选的。
FirmwareInfo[WWAN_FIRMWARE_LEN]
以 NULL 结尾的字符串，表示有关设备的固件特定信息。 此成员是可选的。
MaxActivatedContexts
设备支持的最大已激活上下文数。 微型端口驱动程序应通过失败超过 MaxActivatedContexts 的任何激活尝试来强制实施此限制。
WwanAuthAlgoCaps
表示 MB 设备支持的身份验证方法类型的位图。
| 值 | 含义 |
|---|---|
| WWAN_AUTH_ALGO_CAPS_NONE | MB 设备不支持任何身份验证方法。 |
| WWAN_AUTH_ALGO_CAPS_SIM | MB 设备支持 SIM 身份验证方法。 |
| WWAN_AUTH_ALGO_CAPS_AKA | MB 设备支持 AKA 身份验证方法。 |
| WWAN_AUTH_ALGO_CAPS_AKAP | MB 设备支持 AKA 的 (AKA Prime) 身份验证方法。 |
ExecutorIndex
WWAN_DEVICE_CAPS_EX的 WwanDeviceType 成员不再指调制解调器设备，而是指单个执行程序。 每个设备都是 OS 可识别的 RF 执行程序实体。
WwanOptionalServiceCaps
表示基础调制解调器支持的 Microsoft 服务扩展的 ULONG 结构。 它是一个 64 位位图结构，其未定义的位是保留的，必须设置为“0”。引入新的服务扩展时，保留位将用于表示新的服务扩展。
| 值 | Mask | 含义 | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| WWAN_OPTIONAL_SERVICE_CAPS_NONE | 0h | 设备和驱动程序不支持可选的服务扩展。 | |||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_LTE_ATTACH | 1h |
设备和驱动程序支持 LTE 附加配置和以下 MBIM CID：
|
|||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_CONTEXT_MGMT | 2 小时 |
设备和驱动程序支持 OS 管理调制解调器预配的上下文和以下 MBIM CID：
|
|||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_MULTI_SIM | 4h | 设备和驱动程序支持多 SIM 卡/多执行程序以及以下 OID： | |||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_EX_SAR | 8h |
设备和驱动程序支持 OS 和以下 MBIM CID 中的 SAR 配置：
|
|||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_NETWORK_BLACKLIST | 16h |
来自 OS 和以下 MBIM CID 的网络阻止发件人列表的设备和驱动程序支持配置：
|
|||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_5G_NSA | 设备和驱动程序支持 Windows 10 版本 1903 中的所有与 5G 相关的新扩展。 下表显示了如果设置了此位，微型端口驱动程序必须支持的 NDIS 消息及其修订。
|
WwanSimClassBitMasks
表示 SIM 类掩码的位图。 它必须至少包含与 WwanSimClass 字段对应的掩码。
| 值 |
|---|
| WWAN_SIM_CLASS_MASK_UNKNOWN 0x00000000 |
| WWAN_SIM_CLASS_MASK_EMBEDDED 0x00000001 |
| WWAN_SIM_CLASS_MASK_REMOVABLE 0x00000002 |
| WWAN_SIM_CLASS_MASK_REMOTE 0x00000004 |
WwanWCDMABandClass
FDD 的 3GPP TS25.101 中定义的带区号。 LSB 指示带数 1 (2100MHz) 。
WwanLTEBandClass[WWAN_MAX_NUM_LTE_BAND]
WwanNRBandClass[WWAN_MAX_NUM_NR_BAND]
WwanDataSubClass
表示设备支持的数据子类 (es) 的位图。
| 值 | 含义 |
|---|---|
| WWAN_DATA_SUBCLASS_NONE | 随附的数据类下没有子类。 |
| WWAN_DATA_SUBCLASS_5G_ENDC | 支持 5G 选项 3 中 (UMTS) 地面无线电访问 (E-UTRAN) 和 NR 双重连接。 仅在 WWAN_DATA_CLASS_5G 数据类下有效。 |
| WWAN_DATA_SUBCLASS_5G_NR | 支持 5G 选项 2 中的独立 NR。 仅在 WWAN_DATA_CLASS_5G 数据类下有效。 |
| WWAN_DATA_SUBCLASS_5G_NEDC | 支持 5G 选项 4 中的 NR 和 EUTRAN 双重连接。 仅在 WWAN_DATA_CLASS_5G 数据类下有效。 |
| WWAN_DATA_SUBCLASS_5G_ELTE | 支持与 5G 选项 5 中一样的独立 eLTE。 仅在 WWAN_DATA_CLASS_5G 数据类下有效。 |
| WWAN_DATA_SUBCLASS_5G_NGENDC | 支持 5G 选项 7 中的下一代 eLTE 和 NR 双重连接。 仅在 WWAN_DATA_CLASS_5G 数据类下有效。 |
WwanMiscCaps
表示设备支持的其他功能的位图。 |值| |--- | |WWAN_DEVICE_MISC_CAPS_NONE 0x00000000 | |WWAN_DEVICE_MISC_CAPS_ETHERNET_PDU_SESSION 0x00000001| |WWAN_DEVICE_MISC_CAPS_UNSTRUCTURED_PDU_SESSION 0x00000002| |WWAN_DEVICE_MISC_CAPS_ESIM 0x00000004 | |WWAN_DEVICE_MISC_CAPS_REFLECTIVE_QOS 0x00000008 |
CellularClassListHeader
一个格式化WWAN_LIST_HEADER 对象，该对象表示支持多模式的设备支持的手机网络类列表。 WWAN_LIST_HEADER 中的 ElementType 成员应始终设置为 WwanStructCellularClass。 WWAN_LIST_HEADER 中的 ElementCount 成员设置为遵循WWAN_LIST_HEADER结构的手机网络类数。 不支持多模式的 MB 设备应将 ElementCount 设置为 0。
注解
如果设备支持的数据服务不属于 WwanDataClass 成员的表中定义的任何其他值，微型端口驱动程序应指定WWAN_DATA_CLASS_CUSTOM。 如果微型端口驱动程序设置WWAN_DATA_CLASS_CUSTOM标志，微型端口驱动程序还应提供 CustomDataClass 成员中的数据类的名称。
对于基于 GSM 的设备，必须仅指定基于 GSM 的数据类。 例如，GPRS、EDGE、UMTS、HSDPA、LTE 和 TD-SCDMA。 如果微型端口驱动程序支持 TD-SCDMA，则应在 WwanDataClass 成员中指定WWAN_DATA_CLASS_CUSTOM，并在 CustomDataClass 成员中指定字符串“TD-SCDMA”。
对于基于 CDMA 的设备，必须仅指定与 CDMA 相关的数据服务。 例如，1xRTT、1xEV-DO、1xEV-DO RevA 和 UMB。 1xEV-DO RevB 已定义供将来使用。 还针对完整性定义了 1xEV-DV 和 3xRTT。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 10 版本 1703 |
| 标头 | wwan.h (包括 Wwan.h) |
另请参阅
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈