共用方式為

WWAN_DEVICE_CAPS結構 (wwan.h)

  • 發行項

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 支援全域演進 (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 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 裝置支援僅限美國 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“Wideband Spread Spectrum Systems (SMS) 中所定義。
WWAN_SMS_CAPS_PDU_RECEIVE 針對 GSM 型裝置，此值表示裝置支援接收 PDU 樣式的 SMS 訊息。

若為 CDMA 型裝置，此值表示裝置能夠以二進位格式讀取 SMS 訊息，如 3GPP2 規格 C.S0015- (A“Wideband Spread Spectrum Systems 的 SMS) 一節中所定義。
WWAN_SMS_CAPS_TEXT_SEND 裝置支援傳送文字樣式的SMS訊息。 此旗標適用於CDMA型裝置。
WWAN_SMS_CAPS_TEXT_RECEIVE 裝置支援接收文字樣式的SMS訊息。 此旗標適用於CDMA型裝置。
 

迷你埠驅動程式應該設定此成員，以反映只有 GSM PDU 格式的支援，才能在目前的家用提供者支援多重模式時接收和傳送簡訊。 此外，如果迷你埠驅動程式收到行動數據類別原生格式的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 訊息的迷你埠驅動程式會設定此旗標。

即使網路的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) 驗證方法。
 
注意只有在NDIS_WWAN_DEVICE_CAPS結構的Header.Revision子成員中指定NDIS_WWAN_DEVICE_CAPS_REVISION_2時，這個成員只有在 Windows 8和更新版本中才有效。
 

CellularClassListHeader

格式化WWAN_LIST_HEADER物件，代表支援多重模式裝置之行動數據類別的清單。 WWAN_LIST_HEADER中的 ElementType 成員應該一律設定為 WwanStructCellularClass。 WWAN_LIST_HEADER中的 ElementCount 成員會設定為WWAN_LIST_HEADER結構後面的行動數據類別數目。 不支援多重模式的 MB 裝置應該將 ElementCount 設定為 0。

注意只有在NDIS_WWAN_DEVICE_CAPS結構的Header.Revision子成員中指定NDIS_WWAN_DEVICE_CAPS_REVISION_2時，這個成員只有在 Windows 8和更新版本中才有效。
 

備註

如果裝置支持的數據服務不屬於 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