struttura WWAN_DEVICE_CAPS (wwan.h)
La struttura WWAN_DEVICE_CAPS rappresenta le funzionalità del dispositivo MB.
Sintassi
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;
Membri
WwanDeviceType
Tipo di dispositivo. I driver Miniport devono impostare il tipo di dispositivo come valore diverso da WwanDeviceTypeUnknown.
WwanCellularClass
Classe cellulare del dispositivo. I driver Miniport devono impostare la classe cellulare come valore diverso da WwanCellularClassUnknown. I valori di questo controllo membro sono specifici della tecnologia cellulare, ad esempio le modalità di registrazione del provider di rete.
I driver Miniport che supportano la modalità multipla devono impostare questa opzione su WwanCellularClassGsm.
WwanVoiceClass
Classe vocale del dispositivo. Questo membro informa il servizio MB sulla presenza del servizio vocale del circuito e sul modo in cui tale servizio interagisce con il servizio dati. Tenere presente che il servizio MB non supporta la voce commutata a circuito in modo nativo, né lo impedisce. Spetta al driver miniport determinare come supportare la voce del circuito. Questo membro WwanVoiceClass consente al servizio MB di supportare questa funzionalità in futuro.
WwanSimClass
Classe del Modulo identità sottoscrittore (scheda SIM). I driver Miniport devono impostare la classe SIM come valore diverso da WwanSimClassUnknown.
WwanDataClass
Bitmap che rappresenta la classe dati supportata dal dispositivo. Nella tabella seguente vengono illustrati i valori possibili per questo membro.
| Valore | Significato |
|---|---|
| WWAN_DATA_CLASS_NONE | Il dispositivo non supporta il servizio dati. |
| WWAN_DATA_CLASS_GPRS | Il servizio dati GENERAL Packet Radio Service (GSMS) è supportato. Questo valore si applica solo ai dispositivi basati su GSM. |
| WWAN_DATA_CLASS_EDGE | Sono supportati i dati avanzati per il servizio dati EDGE (Global Evolution). Questo valore si applica solo ai dispositivi basati su GSM. |
| WWAN_DATA_CLASS_UMTS | Il servizio dati Universal Mobile Telecommunications System (UMTS) è supportato. Questo valore si applica solo ai dispositivi basati su GSM. |
| WWAN_DATA_CLASS_HSDPA | High-Speed servizio dati HSDPA (Downlink Packet Access) è supportato. Questo valore si applica solo ai dispositivi basati su GSM. |
| WWAN_DATA_CLASS_HSUPA | High-Speed è supportato il servizio dati HSUPA (Uplink Packet Access). Questo valore si applica solo ai dispositivi basati su GSM. |
| WWAN_DATA_CLASS_LTE | Il servizio dati LTE è supportato. Questo valore si applica solo ai dispositivi basati su GSM. |
| WWAN_DATA_CLASS_5G | Il servizio dati 5G è supportato. |
| WWAN_DATA_CLASS_TDSCDMA | Il servizio dati CDMA sincrono della divisione temporale è supportato. |
| WWAN_DATA_CLASS_1XRTT | È supportato il servizio dati CDMA 1x Radio Transmission Technology (1xRTT, noto anche come cdma2000, CDMA2000 1x e così via). Questo valore si applica solo ai dispositivi basati su CDMA. |
| WWAN_DATA_CLASS_1XEVDO | È supportato CDMA Evolution-Data Optimized (originariamente Data Only, 1xEDVO, noto anche come CDMA2000 1x EV-DO o 1x EVDO). Questo valore si applica solo ai dispositivi basati su CDMA. |
| WWAN_DATA_CLASS_1XEVDO_REVA | Il servizio dati RevA di 1xEVDO è supportato. Questo valore si applica solo ai dispositivi basati su CDMA. |
| WWAN_DATA_CLASS_1XEVDV | È supportato il servizio dati CDMA Evolution-Data/Voice (noto anche come CDMA 2000 1x EV-DV o EVDV 1x). Questo valore si applica solo ai dispositivi basati su CDMA. |
| WWAN_DATA_CLASS_3XRTT | Il servizio dati CDMA 3x Radio Transmission Technology (3xRTT) è supportato. Questo valore si applica solo ai dispositivi basati su CDMA. |
| WWAN_DATA_CLASS_1XEVDO_REVB | Il servizio dati RevB 1xEVDO è supportato. Questo valore si applica solo ai dispositivi basati su CDMA. |
| WWAN_DATA_CLASS_UMB | Il servizio dati UMB è supportato. Questo valore si applica solo ai dispositivi basati su CDMA. |
| WWAN_DATA_CLASS_CUSTOM | Il dispositivo supporta un servizio dati non elencato in questa tabella. |
CustomDataClass[WWAN_CUSTOM_DATA_CLASS_LEN]
Stringa con terminazione NULL che rappresenta il nome della classe di dati personalizzata. Questo membro è valido solo quando il driver miniport imposta il bit WWAN_DATA_CLASS_CUSTOM nel membro WwanDataClass.
WwanGsmBandClass
Bitmap che rappresenta le bande di frequenza supportate dai dispositivi basati su GSM. Nella tabella seguente vengono illustrati i valori possibili per questo membro.
| Valore | Significato |
|---|---|
| WWAN_BAND_CLASS_UNKNOWN | La banda di frequenza supportata dal dispositivo non viene specificata. |
| WWAN_BAND_CLASS_I | Il dispositivo supporta lo spettro UMTS2100. |
| WWAN_BAND_CLASS_II | Il dispositivo supporta lo spettro UMTS1900. |
| WWAN_BAND_CLASS_III | Il dispositivo supporta lo spettro UMTS1800. |
| WWAN_BAND_CLASS_IV | Il dispositivo supporta lo spettro AWS. |
| WWAN_BAND_CLASS_V | Il dispositivo supporta lo spettro UMTS850. |
| WWAN_BAND_CLASS_VI | Il dispositivo supporta lo spettro UMTS800. |
| WWAN_BAND_CLASS_VII | Il dispositivo supporta lo spettro UMTS2600. |
| WWAN_BAND_CLASS_VIII | Il dispositivo supporta lo spettro UMTS900. |
| WWAN_BAND_CLASS_IX | Il dispositivo supporta lo spettro UMTS1700. |
| WWAN_BAND_CLASS_X | |
| WWAN_BAND_CLASS_CUSTOM | Il dispositivo supporta uno spettro diverso da quelli elencati in questa tabella. |
Se il driver miniport specifica WWAN_BAND_CLASS_CUSTOM, deve anche fornire il nome della classe dati in CustomBandClass .
Per altre informazioni su questi valori, vedere OID_WWAN_DEVICE_CAPS.
WwanCdmaBandClass
Bitmap che rappresenta il supporto dei dispositivi basati su CDMA sulle bande di frequenza. Nella tabella seguente vengono illustrati i valori possibili per questo membro.
| Valore | Significato |
|---|---|
| WWAN_BAND_CLASS_UNKNOWN | La banda di frequenza supportata dal dispositivo non viene specificata. |
| WWAN_BAND_CLASS_0 | Il dispositivo supporta la banda 800MHz. |
| WWAN_BAND_CLASS_I | Il dispositivo supporta la banda a 1900 MHz. |
| WWAN_BAND_CLASS_II | Il dispositivo supporta la banda TACS. |
| WWAN_BAND_CLASS_III | Il dispositivo supporta la banda JTACS. |
| WWAN_BAND_CLASS_IV | Il dispositivo supporta la banda PCS coreana. |
| WWAN_BAND_CLASS_V | Il dispositivo supporta la banda a 450 MHz. |
| WWAN_BAND_CLASS_VI | Il dispositivo supporta la banda a 2 GHz. |
| WWAN_BAND_CLASS_VII | Il dispositivo supporta la banda a 700 MHz. |
| WWAN_BAND_CLASS_VIII | Il dispositivo supporta la banda a 1800 MHz. |
| WWAN_BAND_CLASS_IX | Il dispositivo supporta la banda a 900 MHz. |
| WWAN_BAND_CLASS_X | Il dispositivo supporta la banda secondaria a 800 MHz. |
| WWAN_BAND_CLASS_XI | Il dispositivo supporta la banda PAMR europea a 400 MHz. |
| WWAN_BAND_CLASS_XII | Il dispositivo supporta la banda PAMR a 800 MHz. |
| WWAN_BAND_CLASS_XIII | Il dispositivo supporta la banda di estensione da 2,5 GHz IMT2000. |
| WWAN_BAND_CLASS_XIV | Il dispositivo supporta la banda US PCS a 1,9 GHz. |
| WWAN_BAND_CLASS_XV | Il dispositivo supporta la banda AWS. |
| WWAN_BAND_CLASS_XVI | Il dispositivo supporta la banda US a 2,5 GHz. |
| WWAN_BAND_CLASS_XVII | Il dispositivo supporta la banda Us 2,5 GHz Forward Link Only.The device supports the US 2.5 GHz Forward Link Only band. |
| WWAN_BAND_CLASS_CUSTOM | Il dispositivo supporta una banda diversa dalle bande elencate in questa tabella. |
Se il driver miniport specifica WWAN_BAND_CLASS_CUSTOM, deve anche fornire il nome della classe dati in CustomBandClass .
Per altre informazioni su questi valori, vedere OID_WWAN_DEVICE_CAPS.
CustomBandClass[WWAN_CUSTOM_BAND_CLASS_LEN]
Stringa con terminazione NULL che rappresenta il nome della classe band personalizzata. Questo membro è valido solo quando il driver miniport imposta il bit di WWAN_BAND_CLASS_CUSTOM nel WwanGsmBandClass o membri WwanCdmaBandClass, in base alle esigenze.
WwanSmsCaps
Bitmap che rappresenta il tipo di messaggi SMS e flusso direzionale supportato dal dispositivo. La tabella seguente mostra le impostazioni valide delle funzionalità SMS.
| Valore | Significato |
|---|---|
| WWAN_SMS_CAPS_NONE | Il dispositivo non supporta messaggi SMS. |
| WWAN_SMS_CAPS_PDU_SEND |
Per i dispositivi basati su GSM, questo valore significa che il dispositivo supporta l'invio di messaggi SMS in stile PDU.
Per i dispositivi basati su CDMA, questo valore significa che il dispositivo è in grado di inviare messaggi SMS in formato binario come definito nella sezione "3.4.2.1 SMS Point-to-Point Message" nella specifica 3GPP2 C.S0015-A "Short Message Service (SMS) for Wideband Spread Spectrum Systems". |
| WWAN_SMS_CAPS_PDU_RECEIVE |
Per i dispositivi basati su GSM, questo valore significa che il dispositivo supporta la ricezione di messaggi SMS in stile PDU.
Per i dispositivi basati su CDMA, questo valore significa che il dispositivo è in grado di leggere i messaggi SMS in formato binario come definito nella sezione "3.4.2.1 SMS Point-to-Point Message" nella specifica 3GPP2 C.S0015-A "Short Message Service (SMS) for Wideband Spread Spectrum Systems". |
| WWAN_SMS_CAPS_TEXT_SEND | Il dispositivo supporta l'invio di messaggi SMS in stile testo. Questo flag si applica ai dispositivi basati su CDMA. |
| WWAN_SMS_CAPS_TEXT_RECEIVE | Il dispositivo supporta la ricezione di messaggi SMS in stile testo. Questo flag si applica ai dispositivi basati su CDMA. |
I driver Miniport devono impostare questo membro in modo da riflettere il supporto solo per il formato PDU GSM per la ricezione e l'invio di SMS quando il provider home corrente è in grado di supportare la modalità multipla. Pertanto, se il driver miniport riceve un SMS nel formato nativo della classe cellulare, ad esempio CDMA TEXT o CDMA PDU, il driver miniport è necessario per eseguire la traduzione in GSM PDU e indicare il servizio MB. Analogamente, se il driver miniport riceve una richiesta di invio in formato PDU GSM, è necessario eseguire la traduzione nel formato di classe cellulare nativo.
WwanControlCaps
Bitmap che rappresenta le funzionalità di controllo supportate dal dispositivo. La tabella seguente illustra le impostazioni WwanControlCaps valide per i dispositivi basati su GSM e CDMA.
| Valore | Significato |
|---|---|
| WWAN_CTRL_CAPS_REG_MANUAL | Indica se la rete del provider consente la selezione manuale della rete. I driver miniport per i dispositivi basati su GSM devono specificare questo flag. I driver miniport per i dispositivi basati su CDMA non devono specificare questo flag. |
| WWAN_CTRL_CAPS_HW_RADIO_SWITCH | Indica la presenza di un commutatore di alimentazione hardware. Corrisponde al valore WwanDeviceTypeEmbedded dell'enumerazione WWAN_DEVICE_TYPE. |
| WWAN_CTRL_CAPS_CDMA_MOBILE_IP |
Indica che il dispositivo basato su CDMA è configurato per supportare l'INDIRIZZO IP mobile. Questo flag si applica solo ai dispositivi basati su CDMA.
I driver Miniport non devono impostare questo flag quando il provider home corrente è in grado di supportare la modalità multipla. |
| WWAN_CTRL_CAPS_CDMA_SIMPLE_IP |
Indica che il dispositivo basato su CDMA è configurato per il supporto IP semplice. Questo flag si applica solo ai dispositivi basati su CDMA.
I driver Miniport non devono impostare questo flag quando il provider home corrente è in grado di supportare la modalità multipla. |
| WWAN_CTRL_CAPS_CDMA_MOBILE_IP o con WWAN_CTRL_CAPS_CDMA_SIMPLE_IP | Indica che il dispositivo basato su CDMA è configurato per supportare l'INDIRIZZO IP mobile, con un indirizzo IP semplice come opzione di fallback. |
| WWAN_CTRL_CAPS_PROTECT_UNIQUEID | Indica che Windows non deve visualizzare l'identità del Sottoscrittore internazionale per dispositivi mobili (IMSI). |
| WWAN_CTRL_CAPS_USSD |
Indica che il dispositivo MB basato su GSM è configurato per supportare il protocollo USSD. Questo flag si applica solo ai dispositivi basati su GSM.
I driver Miniport che supportano l'invio e la ricezione di messaggi USSD impostano questo flag. I driver Miniport possono impostare questo flag quando il lato GSM corrente dei provider di casa con supporto multi-modalità della rete supporta USSD anche se il lato CDMA della rete non supporta USSD. |
| WWAN_CTRL_CAPS_MODEL_MULTI_CARRIER | Indica che il dispositivo MB supporta la registrazione e la connessione a più operatori di rete. |
| WWAN_CTRL_CAPS_MULTI_MODE | Questo flag indica che il provider home corrente supporta più classi cellulari/RATs (Radio Access Technologies). |
I driver Miniport dei dispositivi basati su CDMA devono specificare WWAN_CTRL_CAPS_CDMA_MOBILE_IP o WWAN_CTRL_CAPS_CDMA_SIMPLE_IP oppure entrambi i flag per informare il servizio MB sul tipo di INDIRIZZO IP supportato dal dispositivo.
DeviceId[WWAN_DEVICEID_LEN]
Stringa con terminazione NULL che rappresenta l'ID dispositivo.
Per i dispositivi basati su GSM, la stringa deve essere conforme al formato IMEI (International Mobile Equipment Identity) (fino a 15 cifre).
Per i dispositivi basati su CDMA, la stringa deve essere conforme ai formati ESN (Electronic Serial Number, 11 digit) e Mobile Equipment Identifier (MEID, 17 cifre).
Per i driver miniport con supporto in più modalità, ad esempio quelli che impostano il flag di WWAN_CTRL_CAPS_MULTI_MODE in WwanControlCaps, è necessario segnalare solo i DeviceId basati su GSM.
Questo valore deve essere archiviato nella memoria del dispositivo e deve essere disponibile anche quando il dispositivo MB/SIM richiede un PIN per sbloccare.
Manufacturer[WWAN_MANUFACTURER_LEN]
Stringa con terminazione NULL che rappresenta il produttore del dispositivo. Questo membro è facoltativo.
Model[WWAN_MODEL_LEN]
Stringa con terminazione NULL che rappresenta il modello del dispositivo. Questo membro è facoltativo.
FirmwareInfo[WWAN_FIRMWARE_LEN]
Stringa con terminazione NULL che rappresenta le informazioni specifiche del firmware sul dispositivo. Questo membro è facoltativo.
MaxActivatedContexts
Numero massimo di contesti attivati supportati dal dispositivo. I driver Miniport devono applicare questo limite non riuscito a tutti i tentativi di attivazione che superano MaxActivatedContexts.
WwanAuthAlgoCaps
Bitmap che rappresenta i tipi di metodi di autenticazione supportati dal dispositivo MB.
| Valore | Significato |
|---|---|
| WWAN_AUTH_ALGO_CAPS_NONE | Il dispositivo MB non supporta metodi di autenticazione. |
| WWAN_AUTH_ALGO_CAPS_SIM | Il dispositivo MB supporta il metodo di autenticazione SIM. |
| WWAN_AUTH_ALGO_CAPS_AKA | Il dispositivo MB supporta il metodo di autenticazione AKA. |
| WWAN_AUTH_ALGO_CAPS_AKAP | Il dispositivo MB supporta il metodo di autenticazione AKA' (AKA Prime). |
CellularClassListHeader
Oggetto WWAN_LIST_HEADER formattato che rappresenta un elenco di classi cellulari supportate da un dispositivo con supporto per più modalità. Il membro ElementType in WWAN_LIST_HEADER deve essere sempre impostato su WwanStructCellularClass. Il membro ElementCount in WWAN_LIST_HEADER è impostato sul numero di classi cellulari che seguono la struttura WWAN_LIST_HEADER. I dispositivi MB che non supportano più modalità devono impostare ElementCount su 0.
Osservazioni
I driver Miniport devono specificare WWAN_DATA_CLASS_CUSTOM se il servizio dati supportato dal dispositivo non appartiene ad altri valori definiti nella tabella per il membro WwanDataClass. Se un driver miniport imposta il flag di WWAN_DATA_CLASS_CUSTOM, il driver miniport deve anche fornire il nome della classe dati nel membro CustomDataClass.
Per i dispositivi basati su GSM, è necessario specificare solo classi di dati basate su GSM. Ad esempio, SAAS, EDGE, UMTS, HSDPA, LTE e TD-SCDMA. Se il driver miniport supporta TD-SCDMA, deve specificare WWAN_DATA_CLASS_CUSTOM nel membro WwanDataClass e la stringa "TD-SCDMA" nel membro CustomDataClass.
Per i dispositivi basati su CDMA, è necessario specificare solo i servizi dati correlati a CDMA. Ad esempio, 1xRTT, 1xEV-DO, 1xEV-DO RevA e UMB. 1xEV-DO RevB è definito per un uso futuro. 1xEV-DV e 3xRTT sono definiti anche per completezza.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows 8 e versioni successive di Windows. |
| intestazione | wwan.h (include Wwan.h) |