WWAN_DEVICE_CAPS_EX結構 (wwan.h)
重要
無偏差通訊
Microsoft 支援多元且包容性的環境。 本文包含無 偏差通訊的 Microsoft 樣式指南 辨識為排除詞彙的參考。 本文中會使用單字或片語來保持一致性，因為它目前會出現在軟體中。 當軟體更新為移除語言時，本文將會更新為一致。
WWAN_DEVICE_CAPS_EX結構代表行動寬頻裝置的功能。 WWAN_DEVICE_CAPS_EX藉由新增執行程式索引成員、追蹤特定執行程式，以及 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
訂閱者識別模組的類別 (SIM 卡) WWAN_SIM_CLASS列舉所 指定。 迷你埠驅動程序必須將 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 Radio Transmission Technology (1xRTT，也稱為 cdma2000、CDMA2000 1x 等等) 數據服務。 此值僅適用於CDMA型裝置。 |
| WWAN_DATA_CLASS_1XEVDO | 支援 CDMA Evolution-Data Optimized (原始數據僅限 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 Radio Transmission Technology (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 | 裝置支援 US PCS 1.9GHz 頻。 |
| WWAN_BAND_CLASS_XV | 裝置支援 AWS 訊號。 |
| WWAN_BAND_CLASS_XVI | 裝置支援US 2.5GHz頻。 |
| WWAN_BAND_CLASS_XVII | 裝置支援僅限 US 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
位圖，表示裝置支援的SMS訊息和方向流程類型。 下表顯示有效的SMS功能設定。
| 值 | 意義 |
|---|---|
| WWAN_SMS_CAPS_NONE | 裝置不支援SMS訊息。 |
| WWAN_SMS_CAPS_PDU_SEND |
針對 GSM 型裝置，此值表示裝置支援傳送 PDU 樣式 SMS 訊息。
針對 CDMA 型裝置，這個值表示裝置能夠以二進位格式傳送簡訊，如 3GPP2 規格 C.S0015-A “Short Message Service () Wideband Spread Spectrum Systems” 一節中所定義。 |
| WWAN_SMS_CAPS_PDU_RECEIVE |
針對 GSM 型裝置，此值表示裝置支援接收 PDU 樣式 SMS 訊息。
針對 CDMA 型裝置，這個值表示裝置能夠讀取 3.4.2.1 SMS 點對點訊息中所定義的二進位格式簡訊，如 3GPP2 規格 C.S0015-A“Short Message Service (Wideband Spread Spectrum Systems 的 SMS) ”。 |
| WWAN_SMS_CAPS_TEXT_SEND | 裝置支援傳送文字樣式簡訊。 此旗標適用於CDMA型裝置。 |
| WWAN_SMS_CAPS_TEXT_RECEIVE | 裝置支援接收文字樣式的SMS訊息。 此旗標適用於CDMA型裝置。 |
迷你埠驅動程式應該設定此成員，以反映只有 GSM PDU 格式的支援，才能在目前的主提供者具備多重模式時接收和傳送 SMS。 如果迷你埠驅動程式收到行動數據類別原生格式的SMS，例如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或搭配 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 (Radio Access Technologies) 。 |
CDMA 型裝置的迷你埠驅動程式必須指定WWAN_CTRL_CAPS_CDMA_MOBILE_IP或WWAN_CTRL_CAPS_CDMA_SIMPLE_IP，或兩個旗標，以通知 MB 服務裝置支援的 IP 類型。
DeviceId[WWAN_DEVICEID_LEN]
代表裝置標識碼的NULL終止字串。
針對 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
ULONG 結構，代表基礎數據機支援的 Microsoft 服務延伸模組。 它是 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 | 2h |
裝置和驅動程式支援管理數據機布建內容的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
位圖，表示裝置支援的數據子類別 () 。
| 值 | 意義 |
|---|---|
| WWAN_DATA_SUBCLASS_NONE | 隨附的數據類別下沒有子類別。 |
| WWAN_DATA_SUBCLASS_5G_ENDC | 已演進的通用行動電信系統 (UMTS) 實時無線存取 (E-UTRAN) 和 NR 雙重連線，如 5G 選項 3 支援。 只有在WWAN_DATA_CLASS_5G數據類別下才有效。 |
| WWAN_DATA_SUBCLASS_5G_NR | 支持獨立 NR，如 5G 選項 2 所示。 只有在WWAN_DATA_CLASS_5G數據類別下才有效。 |
| WWAN_DATA_SUBCLASS_5G_NEDC | 支援 NR 和 EUTRAN 雙重連線，如 5G 選項 4 所示。 只有在WWAN_DATA_CLASS_5G數據類別下才有效。 |
| WWAN_DATA_SUBCLASS_5G_ELTE | 支持獨立 eLTE，如 5G 選項 5 所示。 只有在WWAN_DATA_CLASS_5G數據類別下才有效。 |
| WWAN_DATA_SUBCLASS_5G_NGENDC | 支援下一代 eLTE 和 NR 雙重連線，如 5G 選項 7 所示。 只有在WWAN_DATA_CLASS_5G數據類別下才有效。 |
WwanMiscCaps
點陣圖，表示裝置支援其他功能。 |Value| |--- | |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) |