WWAN_DEVICE_CAPS_EX_REV1 結構 (wwan.h)

重要

無偏差通訊

Microsoft 支援多元且包容性的環境。 本文包含 Microsoft 適用於無偏差通訊 的術語參考，可辨識為排除。 本文中會使用單字或片語進行一致性，因為它目前會出現在軟體中。 當軟體更新為移除語言時，本文將會更新為一致。

WWAN_DEVICE_CAPS_EX_REV1結構代表行動寬頻裝置的功能。 WWAN_DEVICE_CAPS_EX_REV1 移除下列欄位，以更新現有的 WWAN_DEVICE_CAPS_EX 結構：

• WwanSimClassBitMasks
• WwanWCDMABandClass
• WwanLTEBandClass
• WwanNRBandClass
• WwanMiscCaps

語法

typedef struct _WWAN_DEVICE_CAPS_EX_REV1 {
  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;
  WWAN_LIST_HEADER    CellularClassListHeader;
} WWAN_DEVICE_CAPS_EX_REV1, *PWWAN_DEVICE_CAPS_EX_REV1;

成員

WwanDeviceType

裝置的類型。 迷你埠驅動程序必須將裝置類型設定為 WwanDeviceTypeUnknown 以外的值。

WwanCellularClass

裝置的行動數據類別。 迷你埠驅動程序必須將行動數據類別設定為 WwanCellularClassUnknown 以外的值。 此成員控制功能中特定行動數據技術的值，例如網路提供者註冊模式。

支援多重模式的迷你埠驅動程式應將此設定為 WwanCellularClassGsm。

WwanVoiceClass

裝置的語音類別。 此成員會通知 MB 服務是否有線路語音服務，以及這類服務如何與數據服務互動。 請注意，MB 服務不支援原生線路切換語音，也不會排除它。 您可以透過迷你埠驅動程序來判斷如何支援線路語音。 此 WwanVoiceClass 成員可讓 MB 服務在未來支援此功能。

WwanSimClass

訂閱者身分識別模組的類別 (SIM 卡) 。 Miniport 驅動程式必須將 SIM 類別設定為 WwanSimClassUnknown 以外的值。

WwanDataClass

位圖，表示裝置支援的數據類別 () 。 下表顯示這個成員的可能值。

值	意義
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	支援 5G 資料服務。
WWAN_DATA_CLASS_TDSCDMA	支持時間除法同步CDMA資料服務。
WWAN_DATA_CLASS_1XRTT	支援 CDMA 1x Radio Transmission Technology (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 演進/資料/語音 (也稱為 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 終止的字串，表示自訂資料類別的名稱。 只有當 miniport 驅動程式在 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_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 訊息的迷你埠驅動程式會設定此旗標。 即使網路的CDMA端不支援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_REV1的 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： MBIM_CID_MS_LTE_ATTACH_CONFIG MBIM_CID_MS_LTE_ATTACH_STATUS
WWAN_OPTIONAL_SERVICE_CAPS_CONTEXT_MGMT	2h	裝置和驅動程式支援 OS 管理數據機布建的內容和下列 MBIM CID： MBIM_CID_PROVISIONED_CONTEXT_V2
WWAN_OPTIONAL_SERVICE_CAPS_MULTI_SIM	4h	裝置和驅動程式支援多 SIM/多執行程式和下列 OID： OID_WWAN_SYS_CAPS_INFO OID_WWAN_DEVICE_SLOT_MAPPING_INFO OID_WWAN_SLOT_INFO
WWAN_OPTIONAL_SERVICE_CAPS_EX_SAR	8h	裝置與驅動程式支援來自 OS 和下列 MBIM CID 的 SAR 設定： MBIM_CID_MS_SAR_CONFIG MBIM_CID_MS_TRANSMISSION_STATUS
WWAN_OPTIONAL_SERVICE_CAPS_NETWORK_BLACKLIST	16h	裝置和驅動程式支援從 OS 和下列 MBIM CID 設定網路封鎖的寄件者清單： MBIM_CID_MS_NETWORK_BLACKLIST
WWAN_OPTIONAL_SERVICE_CAPS_5G_NSA		裝置和驅動程式支援 Windows 10 1903 版中的所有新 5G 相關擴充功能。 下表顯示設定此位時，迷你埠驅動程序必須支援的 NDIS 訊息及其修訂。 OID 訊息 修訂版 WWAN_DEVICE_CAPS_EX NDIS_WWAN_DEVICE_CAPS_EX 1 WWAN_REGISTER_STATE NDIS_WWAN_REGISTRATION_STATE 3 WWAN_PACKET_SERVICE NDIS_WWAN_PACKET_SERVICE_STATE 2 WWAN_SIGNAL_STATE NDIS_WWAN_SIGNAL_STATE 2

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 (版本 2004)
標頭	wwan.h

另請參閱

WWAN_DEVICE_CAPS_EX

NDIS_WWAN_DEVICE_CAPS

WWAN_CELLULAR_CLASS

WWAN_DEVICE_TYPE

WWAN_SIM_CLASS

WWAN_VOICE_CLASS