struttura WWAN_SIGNAL_STATE (wwan.h)
La struttura WWAN_SIGNAL_STATE rappresenta lo stato del segnale del dispositivo MB.
Sintassi
typedef struct _WWAN_SIGNAL_STATE {
ULONG Rssi;
ULONG ErrorRate;
ULONG RssiInterval;
ULONG RssiThreshold;
WWAN_LIST_HEADER SignalStateListHeader;
} WWAN_SIGNAL_STATE, *PWWAN_SIGNAL_STATE;
Members
Rssi
Valore che rappresenta la forza del segnale wireless. I driver Miniport che segnalano il WWAN_CELLULAR_CLASS per essere WwanCellularClassGSM o WwanCellularClassCDMA devono segnalare rssi in decibel sopra il pavimento del rumore di sensibilità del dispositivo.
| Forza segnale (in dBm) | Valore codificato (minimo=0, massimo=31) |
|---|---|
| -113 o meno | 0 |
| -111 | 1 |
| -109 | 2 |
| ... | ... |
| -51 o versione successiva | 31 |
| Sconosciuto o non rilevabile | WWAN_RSSI_UNKNOWN |
I dispositivi basati su CDMA devono segnalare la forza del segnale in base a RSSI compensati (account di disturbo) e non basati su RSSI non elaborati.
ErrorRate
Valore codificato che rappresenta un intervallo percentuale di percentuali di errori. Per i dispositivi basati su GSM, usare i valori della colonna Frequenza degli errori di bit del canale nella tabella seguente. Per i dispositivi basati su CDMA, usare i valori della colonna Frequenza errori frame. Per entrambi i casi, usare WWAN_ERROR_RATE_UNKNOWN per indicare una frequenza di errore sconosciuta.
| Frequenza degli errori di bit del canale (in %) | Frequenza degli errori di fotogrammi (in %) | Valore codificato (Min=0, Max=7) |
|---|---|---|
| < 0.2 | < 0.01 | 0 |
| 0.2-0.4 | 0.01-0.1 | 1 |
| 0.4-0.8 | 0.1-0.5 | 2 |
| 0.8-1.6 | 0.5-1.0 | 3 |
| - 3.2 | 1.0 - -2.0 | 4 |
| - 6.4 | 2.0-4.0 | 5 |
| 6.4-12.8 | 4.0-8.0 | 6 |
| > 12.8 | > 8.0 | 7 |
| Sconosciuto o non rilevabile | WWAN_ERROR_RATE_UNKNOWN | |
RssiInterval
Intervallo corrente, in secondi, in cui il driver miniport è stato impostato su (o l'intervallo predefinito, se non è stato impostato), che il driver miniport fornirà aggiornamenti sullo stato del segnale. Specificare WWAN_RSSI_DISABLE per indicare che il driver miniport non implementa la creazione di report basati su intervalli. I driver Miniport devono popolare questo membro con l'intervallo in risposta a una richiesta precedente del servizio MB per WWAN_RSSI_DEFAULT.
RssiThreshold
La soglia corrente, in unità soglia, in cui il driver miniport è stato impostato su (o l'intervallo predefinito, se non è stato impostato), che il driver miniport fornirà aggiornamenti sullo stato del segnale. Specificare WWAN_RSSI_DISABLE per indicare che il driver miniport non implementa la creazione di report basati su soglia. I driver Miniport devono popolare questo membro con le unità soglia in risposta a una richiesta precedente del servizio MB per WWAN_RSSI_DEFAULT.
SignalStateListHeader
Struttura formattata WWAN_LIST_HEADER che rappresenta un elenco di estensioni dello stato del segnale per classe di dati e il numero di classi di dati. Il driver miniport deve restituire un elenco di tutte le classi di dati supportate.
Questo membro punta a un elenco di strutture WWAN_SIGNAL_STATE_EXT che utilizzano la struttura WWAN_LIST_HEADER . Il resto dei membri delle strutture WWAN_SIGNAL_STATE_EX viene riempito in base alla classe di dati più elevata disponibile.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 7 e versioni successive di Windows. |
| Intestazione | wwan.h (include Wwan.h) |