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)

Confira também

NDIS_WWAN_SIGNAL_STATE