WWAN_DEVICE_CAPS_EX_REV1 struttura (wwan.h)
Importante
Comunicazione senza distorsione
Microsoft supporta un ambiente diversificato e inclusivo. Questo articolo contiene riferimenti alla terminologia che la guida allo stile Microsoft per la comunicazione senza pregiudizi riconosce come esclusioni. La parola o la frase viene usata in questo articolo per la coerenza perché attualmente viene visualizzata nel software. Quando il software viene aggiornato per rimuovere la lingua, questo articolo verrà aggiornato in allineamento.
La struttura WWAN_DEVICE_CAPS_EX_REV1 rappresenta le funzionalità di un dispositivo a banda larga mobile. WWAN_DEVICE_CAPS_EX_REV1 aggiorna la struttura WWAN_DEVICE_CAPS_EX esistente rimuovendo i campi seguenti:
- WwanSimClassBitMasks
- WwanWCDMABandClass
- WwanLTEBandClass
- WwanNRBandClass
- WwanMiscCaps
Sintassi
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;
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 anche specificare il nome della classe di 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. 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_0 | Il dispositivo supporta la banda 800MHz. |
| WWAN_BAND_CLASS_I | Il dispositivo supporta la banda 1900MHz. |
| 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 450 MHz. |
| WWAN_BAND_CLASS_VI | Il dispositivo supporta la banda 2 GHz. |
| WWAN_BAND_CLASS_VII | Il dispositivo supporta la banda da 700 MHz. |
| WWAN_BAND_CLASS_VIII | Il dispositivo supporta la banda da 1800 MHz. |
| WWAN_BAND_CLASS_IX | Il dispositivo supporta la banda da 900 MHz. |
| WWAN_BAND_CLASS_X | Il dispositivo supporta la banda secondaria da 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,5GHz. |
| WWAN_BAND_CLASS_XIV | Il dispositivo supporta la banda US PCS 1.9GHz. |
| WWAN_BAND_CLASS_XV | Il dispositivo supporta la banda AWS. |
| WWAN_BAND_CLASS_XVI | Il dispositivo supporta la banda US 2,5GHz. |
| WWAN_BAND_CLASS_XVII | Il dispositivo supporta la banda solo collegamento avanti us 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 anche specificare il nome della classe di 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 mostra 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.S00015-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 per 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 più modalità. 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 PDU GSM 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 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 WwanDeviceTypeEmbeddeded dell'enumerazione WWAN_DEVICE_TYPE. |
| WWAN_CTRL_CAPS_CDMA_MOBILE_IP | Indica che il dispositivo basato su CDMA è configurato per supportare l'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 più modalità. |
| 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 più modalità. |
| WWAN_CTRL_CAPS_CDMA_MOBILE_IP combinata con WWAN_CTRL_CAPS_CDMA_SIMPLE_IP | Indica che il dispositivo basato su CDMA è configurato per supportare l'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 mobile internazionale (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 con funzionalità multi-mode corrente 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 (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). |
ExecutorIndex
Il membro WwanDeviceType per WWAN_DEVICE_CAPS_EX_REV1 non fa più riferimento al dispositivo modem, ma piuttosto a un singolo executor. Ogni dispositivo è un'entità dell'executor RF di cui è a conoscenza il sistema operativo.
WwanOptionalServiceCaps
Struttura ULONG che rappresenta l'estensione del servizio Microsoft supporta il modem sottostante. Si tratta di una struttura bitmap a 64 bit che i cui bit non definiti sono riservati e devono essere impostati su "0". Man mano che vengono introdotte nuove estensioni del servizio, i bit riservati verranno usati per rappresentare le nuove estensioni del servizio.
| Valore | Mask | Significato | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| WWAN_OPTIONAL_SERVICE_CAPS_NONE | 0h | Il dispositivo e il driver non supportano estensioni di servizio facoltative. | |||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_LTE_ATTACH | 1h | Il dispositivo e il driver supportano la configurazione del collegamento LTE e i CID MBIM seguenti:
|
|||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_CONTEXT_MGMT | 2 h | Il dispositivo e il driver supportano il sistema operativo che gestisce i contesti di provisioning del modem e il CID MBIM seguente:
|
|||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_MULTI_SIM | 4h | Il dispositivo e il driver supportano multi-SIM/multi-execuors e gli OID seguenti: | |||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_EX_SAR | 8h | Il dispositivo e il driver supportano la configurazione SAR dal sistema operativo e dai CID MBIM seguenti:
|
|||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_NETWORK_BLACKLIST | 16h | Il dispositivo e il driver supportano la configurazione dei mittenti bloccati di rete dal sistema operativo e dal CID MBIM seguente:
|
|||||||||||||||
| WWAN_OPTIONAL_SERVICE_CAPS_5G_NSA | Il dispositivo e il driver supportano tutte le nuove estensioni correlate al 5G in Windows 10 versione 1903. La tabella seguente mostra i messaggi NDIS e le relative revisioni che il driver miniport deve supportare se questo bit è impostato.
|
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 | Windows 10, versione 2004 |
| Intestazione | wwan.h |