estrutura WWAN_SIGNAL_STATE (wwan.h)
A estrutura WWAN_SIGNAL_STATE representa o estado do sinal do dispositivo MB.
Sintaxe
typedef struct _WWAN_SIGNAL_STATE {
ULONG Rssi;
ULONG ErrorRate;
ULONG RssiInterval;
ULONG RssiThreshold;
WWAN_LIST_HEADER SignalStateListHeader;
} WWAN_SIGNAL_STATE, *PWWAN_SIGNAL_STATE;
Membros
Rssi
Um valor que representa a força do sinal sem fio. Os drivers de miniport que relatam sua WWAN_CELLULAR_CLASS ser WwanCellularClassGSM ou WwanCellularClassCDMA devem relatar Rssi em decibéis acima do piso de ruído de confidencialidade do dispositivo.
| Intensidade do sinal (no dBm) | Valor codificado (Mínimo=0, Máximo=31) |
|---|---|
| -113 ou menos | 0 |
| -111 | 1 |
| -109 | 2 |
| ... | ... |
| -51 ou superior | 31 |
| Desconhecido ou indetectável | WWAN_RSSI_UNKNOWN |
Os dispositivos baseados em CDMA devem relatar a intensidade do sinal com base no RSSI compensado (contas de ruído) e não com base no RSSI bruto.
ErrorRate
Um valor codificado que representa um intervalo percentual de taxas de erro. Para dispositivos baseados em GSM, use os valores da coluna Taxa de erros de bits do Canal na tabela a seguir. Para dispositivos baseados em CDMA, use os valores da coluna Taxa de erros de quadro. Para ambos os casos, use WWAN_ERROR_RATE_UNKNOWN para indicar uma taxa de erro desconhecida.
| Taxa de erros de bits de canal (em %) | Taxa de erros de quadro (em %) | Valor codificado (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 |
| Desconhecido ou indetectável | WWAN_ERROR_RATE_UNKNOWN | |
RssiInterval
O intervalo atual, em segundos, no qual o driver de miniporto foi definido como (ou o intervalo padrão, se um não tiver sido definido), que o driver de miniporto fornecerá atualizações sobre o estado do sinal. Especifique WWAN_RSSI_DISABLE para indicar que o driver de miniporto não implementa relatórios baseados em intervalo. Os drivers de miniport devem preencher esse membro com o intervalo em resposta a uma solicitação anterior do Serviço MB para WWAN_RSSI_DEFAULT.
RssiThreshold
O limite atual, em unidades de limite, em que o driver de miniporto foi definido como (ou o intervalo padrão, se um não tiver sido definido), que o driver de miniporto fornecerá atualizações sobre o estado do sinal. Especifique WWAN_RSSI_DISABLE para indicar que o driver de miniporto não implementa relatórios baseados em limite. Os drivers de miniport devem preencher esse membro com as unidades de limite em resposta a uma solicitação anterior do Serviço MB para WWAN_RSSI_DEFAULT.
SignalStateListHeader
Uma estrutura de WWAN_LIST_HEADER formatada que representa uma lista de extensões de estado de sinal por classe de dados e o número de classes de dados. O driver de miniporta deve retornar uma lista de todas as classes de dados com suporte.
Esse membro aponta para uma lista de estruturas WWAN_SIGNAL_STATE_EXT que usam a estrutura WWAN_LIST_HEADER . O restante dos membros das estruturas de WWAN_SIGNAL_STATE_EX são preenchidos com base na classe de dados mais alta disponível.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows 7 e versões posteriores do Windows. |
| Cabeçalho | wwan.h (inclua Wwan.h) |