struttura WWAN_DEVICE_CAPS_EX (wwan.h)

La struttura WWAN_DEVICE_CAPS_EX rappresenta le funzionalità del dispositivo mobile broadband. WWAN_DEVICE_CAPS_EX estende la struttura WWAN_DEVICE_CAPS esistente aggiungendo un membro Executor Index , per tenere traccia di executor specifici e un membro WwanOptionalServiceCaps per le estensioni del servizio Microsoft.

Sintassi

typedef struct _WWAN_DEVICE_CAPS_EX {
  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;
  ULONG               WwanSimClassBitMasks;
  ULONG               WwanWCDMABandClass;
  USHORT              WwanLTEBandClass[WWAN_MAX_NUM_LTE_BAND];
  USHORT              WwanNRBandClass[WWAN_MAX_NUM_NR_BAND];
  ULONGLONG           WwanDataSubClass;
  ULONGLONG           WwanMiscCaps;
  WWAN_LIST_HEADER    CellularClassListHeader;
} WWAN_DEVICE_CAPS_EX, *PWWAN_DEVICE_CAPS_EX;

Members

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 cellular come valore diverso da WwanCellClassUnknown. 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 impostarlo su WwanMultidimensionalClassGsm.

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 a commutazione di 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) specificata dall'enumerazione WWAN_SIM_CLASS . I driver Miniport devono impostare la classe SIM come valore diverso da WwanSimClassUnknown.

WwanDataClass

Bitmap che rappresenta la classe di dati supportata dal dispositivo. Nella tabella seguente vengono illustrati i valori possibili per questo membro.

CustomDataClass[WWAN_CUSTOM_DATA_CLASS_LEN]

Stringa con terminazione NULL che rappresenta il nome della classe dati personalizzata. Questo membro è valido solo quando il driver miniport imposta il bit WWAN_DATA_CLASS_CUSTOM nel membro WwanDataClass .

WwanGsmBandClass

Bitmap che rappresenta il supporto dei dispositivi basati su GSM per le bande di frequenza. Nella tabella seguente vengono illustrati i valori possibili per questo membro.

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.

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.

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.

I driver miniport dei dispositivi basati su CDMA devono specificare WWAN_CTRL_CAPS_CDMA_MOBILE_IP, WWAN_CTRL_CAPS_CDMA_SIMPLE_IP o 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 per più modalità, ad esempio quelli che impostano il flag 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 non superati i tentativi di attivazione che superano MaxActivatedContexts.

WwanAuthAlgoCaps

Bitmap che rappresenta i tipi di metodi di autenticazione supportati dal dispositivo MB.

ExecutorIndex

Il membro WwanDeviceType per WWAN_DEVICE_CAPS_EX non fa più riferimento al dispositivo modem, ma piuttosto a un singolo executor. Ogni dispositivo è un'entità executor RF di cui il sistema operativo è a conoscenza.

WwanOptionalServiceCaps

Struttura ULONG che rappresenta le estensioni del servizio Microsoft supportate dal modem sottostante. Si tratta di una struttura bitmap a 64 bit 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.

WwanSimClassBitMasks

Bitmap che rappresenta le maschere della classe SIM. Deve contenere almeno la maschera corrispondente al campo WwanSimClass .

WwanWCDMABandClass

Numero di banda definito in 3GPP TS25.101 per FDD. LSB indica il numero di banda 1 (2100MHz).

WwanLTEBandClass[WWAN_MAX_NUM_LTE_BAND]

WwanNRBandClass[WWAN_MAX_NUM_NR_BAND]

WwanDataSubClass

Bitmap che rappresenta la sottoclasse di dati supportata dal dispositivo.

WwanMiscCaps

Bitmap che rappresenta varie funzionalità supportate dal dispositivo. |Valore| |--- | |WWAN_DEVICE_MISC_CAPS_NONE 0x00000000 | |WWAN_DEVICE_MISC_CAPS_ETHERNET_PDU_SESSION 0x00000001 | |WWAN_DEVICE_MISC_CAPS_UNSTRUCTURED_PDU_SESSION 0x00000002 | |WWAN_DEVICE_MISC_CAPS_ESIM 0x00000004 | |WWAN_DEVICE_MISC_CAPS_REFLECTIVE_QOS 0x00000008|

CellularClassListHeader

Oggetto formattato WWAN_LIST_HEADER 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 WwanStructCellClass. Il membro ElementCount in WWAN_LIST_HEADER è impostato sul numero di classi cellulare che seguono la struttura WWAN_LIST_HEADER. I dispositivi MB che non supportano la 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 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, CRITERI, 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 un uso futuro. Sono definiti anche 1xEV-DV e 3xRTT per completezza.

Requisiti

Vedi anche

NDIS_WWAN_DEVICE_CAPS_EX

OID_WWAN_DEVICE_CAPS_EX

WWAN_DEVICE_CAPS