WWAN_DEVICE_CAPS struttura (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;
Members
WwanDeviceType
Tipo del 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 dal circuito in modo nativo, né lo impedisce. Si tratta del driver miniport per 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 di dati (es) supportata dal dispositivo. La tabella seguente mostra 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 (MDFS) è supportato. Questo valore si applica solo ai dispositivi basati su GSM. |
| WWAN_DATA_CLASS_EDGE | Il servizio dati Avanzato per Global Evolution (EDGE) è supportato. Questo valore si applica solo ai dispositivi basati su GSM. |
| WWAN_DATA_CLASS_UMTS | Il servizio dati UMTS (Universal Mobile Tetelecomunicazion System) è 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 servizio dati HSUPA (Uplink Packet Access) è supportato. 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 | CdMA 1x Radio Transmission Technology (1xRTT, noto anche come cdma2000, CDMA2000 1x e così via) è supportato il servizio dati. Questo valore si applica solo ai dispositivi basati su CDMA. |
| WWAN_DATA_CLASS_1XEVDO | CdMA Evolution-Data Optimized (originariamente Data Only, 1xEDVO, noto anche come CDMA2000 1x EV-DO o 1x EVDO) è supportato. Questo valore si applica solo ai dispositivi basati su CDMA. |
| WWAN_DATA_CLASS_1XEVDO_REVA | Il servizio dati RevA 1xEVDO è supportato. Questo valore si applica solo ai dispositivi basati su CDMA. |
| WWAN_DATA_CLASS_1XEVDV | Il servizio dati CDMA Evolution-Data/Voice (noto anche come CDMA 2000 1x EV-DV o 1x EVDV) è supportato. 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 di WWAN_DATA_CLASS_CUSTOM nel membro WwanDataClass .
WwanGsmBandClass
Bitmap che rappresenta il supporto dei dispositivi basati su GSM sulle bande di frequenza. La tabella seguente mostra 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 di 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 di 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 specificare anche 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 per le 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 da 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 IMT2000 2,5 GHz. |
| 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 Forward Link Only da 2,5 GHz. |
| 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 specificare anche 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 WWAN_BAND_CLASS_CUSTOM nei membri WwanGsmBandClass o WwanCdmaBandClass , in base alle esigenze.
WwanSmsCaps
Bitmap che rappresenta il tipo di messaggi SMS e flusso direzionale supportato dal dispositivo. La tabella seguente illustra le impostazioni valide per le funzionalità SMS.
| Valore | Significato |
|---|---|
| WWAN_SMS_CAPS_NONE | Il dispositivo non supporta i 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 modalità multipla. Se il driver miniport riceve un SMS nel formato nativo della classe cellulare, ad esempio CDMA TEXT o CDMA PDU, il driver miniport deve 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 della classe cellulare nativa.
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 BASATI su 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 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 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 di 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 home con supporto per più modalità 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 (Tecnologie di accesso radio). |
I driver miniport dei dispositivi basati su CDMA devono specificare WWAN_CTRL_CAPS_CDMA_MOBILE_IP o WWAN_CTRL_CAPS_CDMA_SIMPLE_IP o entrambi i flag per informare il servizio MB sul tipo di 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 (ESN, 11 cifre) e Mobile Equipment Identifier (MEID, 17 cifre).
Per i driver miniport in modalità multipla, ad esempio quelli che impostano il flag di WWAN_CTRL_CAPS_MULTI_MODE in WwanControlCaps, è necessario segnalare solo DeviceId basato 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 eseguendo eventuali 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 in modalità multipla. 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 sono in modalità multipla devono impostare ElementCount su 0.
Commenti
I driver Miniport devono specificare WWAN_DATA_CLASS_CUSTOM se il servizio dati supportato dal dispositivo non appartiene ad alcun altro valore definito nella tabella per il membro WwanDataClass . Se un driver miniport imposta il flag di WWAN_DATA_CLASS_CUSTOM, il driver miniport deve specificare anche il nome della classe di dati nel membro CustomDataClass .
Per i dispositivi basati su GSM, è necessario specificare solo classi di dati basate su GSM. Ad esempio, MDFS, EDGE, UMTS, HSDPA, LTE e TD-SCDMA. Se il driver miniport supporta TD-SCDMA, deve specificare WWAN_DATA_CLASS_CUSTOM nel membro WwanDataClass e nella 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 l'uso futuro. Anche 1xEV-DV e 3xRTT sono definiti per la completezza.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 8 e versioni successive di Windows. |
| Intestazione | wwan.h (include Wwan.h) |