通过

wwan.h) (WWAN_DEVICE_CAPS 结构

  • 项目

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 也是为完整性定义的。

要求

要求 值
最低受支持的客户端 适用于 Windows 8 及更高版本的 Windows。
标头 wwan.h (包括 Wwan.h)

另请参阅

NDIS_WWAN_DEVICE_CAPS

WWAN_CELLULAR_CLASS

WWAN_DEVICE_TYPE

WWAN_SIM_CLASS

WWAN_VOICE_CLASS