wwan.h) (WWAN_DEVICE_CAPS 结构

项目
02/27/2024

WWAN_DEVICE_CAPS 结构表示 MB 设备的功能。

语法

typedef struct _WWAN_DEVICE_CAPS {
  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;
  WWAN_LIST_HEADER    CellularClassListHeader;
} WWAN_DEVICE_CAPS, *PWWAN_DEVICE_CAPS;

成员

WwanDeviceType

设备的类型。微型端口驱动程序必须将设备类型设置为 WwanDeviceTypeUnknown 以外的值。

WwanCellularClass

设备的手机网络类。微型端口驱动程序必须将手机网络类设置为 WwanCellularClassUnknown 以外的值。此成员中的值控制特定于手机网络技术的功能，例如网络提供商注册模式。

支持多模式的微型端口驱动程序应将此设置为 WwanCellularClassGsm。

WwanVoiceClass

设备的语音类。此成员通知 MB 服务是否存在线路语音服务，以及此类服务如何与数据服务交互。请注意，MB 服务本身不支持线路切换语音，也不排除它。由微型端口驱动程序决定如何支持线路语音。此 WwanVoiceClass 成员允许 MB 服务在将来支持此功能。

WwanSimClass

订阅者标识模块的类 (SIM 卡) 。微型端口驱动程序必须将 SIM 类设置为 WwanSimClassUnknown 以外的值。

WwanDataClass

表示设备支持的数据类 (es) 的位图。下表显示了此成员的可能值。

值	含义
WWAN_DATA_CLASS_NONE	设备不支持数据服务。
WWAN_DATA_CLASS_GPRS	支持常规数据包无线电服务 (GPRS) 数据服务。此值仅适用于基于 GSM 的设备。
WWAN_DATA_CLASS_EDGE	支持 Global Evolution (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	支持 5G 数据服务。
WWAN_DATA_CLASS_TDSCDMA	支持时分同步 CDMA 数据服务。
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_MOBILE_IP ored with WWAN_CTRL_CAPS_CDMA_SIMPLE_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	此标志指示当前家庭提供商支持多个手机网络类/RAT (无线电访问技术) 。

基于 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

设备支持的最大已激活上下文数。微型端口驱动程序应通过失败超过 MaxActivatedContext 的任何激活尝试来强制实施此限制。

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) 身份验证方法。

注意此成员仅在 Windows 8 及更高版本中有效，在 NDIS_WWAN_DEVICE_CAPS 结构的 Header.Revision 子成员中指定了 NDIS_WWAN_DEVICE_CAPS_REVISION_2。

CellularClassListHeader

一个格式化WWAN_LIST_HEADER对象，表示支持多模式的设备支持的手机网络类列表。 WWAN_LIST_HEADER中的 ElementType 成员应始终设置为 WwanStructCellularClass。 WWAN_LIST_HEADER 中的 ElementCount 成员设置为遵循WWAN_LIST_HEADER结构的手机网络类数。不支持多模式的 MB 设备应将 ElementCount 设置为 0。

注意此成员仅在 Windows 8 及更高版本中有效，在 NDIS_WWAN_DEVICE_CAPS 结构的 Header.Revision 子成员中指定了 NDIS_WWAN_DEVICE_CAPS_REVISION_2。

注解

如果设备支持的数据服务不属于 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 也是为完整性定义的。