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.

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.

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 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.

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

Vedi anche

NDIS_WWAN_DEVICE_CAPS

WWAN_CELLULAR_CLASS

WWAN_DEVICE_TYPE

WWAN_SIM_CLASS

WWAN_VOICE_CLASS