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 seus WWAN_CELLULAR_CLASS ser WwanCellularClassGSM ou WwanCellularClassCDMA devem relatar Rssi em decibéis acima do piso de ruído de confidencialidade do dispositivo.
| Força do sinal (em 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 força 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 de taxa de erro de bit do Canal na tabela a seguir. Para dispositivos baseados em CDMA, use os valores da coluna de taxa de erro Frame. Para ambos os casos, use WWAN_ERROR_RATE_UNKNOWN para indicar uma taxa de erro desconhecida.
| Taxa de erro de bit do canal (em %) | Taxa de erro 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 (ou o intervalo padrão, se um não tiver sido definido), 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 miniporto 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 (ou o intervalo padrão, se 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 miniporto 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 miniporto 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 |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows 7 e versões posteriores do Windows. |
| cabeçalho | wwan.h (inclua Wwan.h) |