structure WWAN_SIGNAL_STATE (wwan.h)

  • Article

La structure WWAN_SIGNAL_STATE représente l’état du signal de l’appareil Mo.

Syntaxe

typedef struct _WWAN_SIGNAL_STATE {
  ULONG            Rssi;
  ULONG            ErrorRate;
  ULONG            RssiInterval;
  ULONG            RssiThreshold;
  WWAN_LIST_HEADER SignalStateListHeader;
} WWAN_SIGNAL_STATE, *PWWAN_SIGNAL_STATE;

Membres

Rssi

Valeur qui représente la force du signal sans fil. Les pilotes miniports qui signalent leur WWAN_CELLULAR_CLASS être WwanCellularClassGSM ou WwanCellularClassCDMA doivent signaler rssi en décibels au-dessus du plancher de sensibilité du bruit de l’appareil.

Force du signal (en dBm) Valeur codée (Minimum=0, Maximum=31)
-113 ou moins 0
-111 1
-109 2
... ...
-51 ou supérieur 31
Inconnu ou indétectable WWAN_RSSI_UNKNOWN
 

Les appareils basés sur CDMA doivent signaler la puissance du signal en fonction de RSSI (comptes pour le bruit) compensés et non d’après RSSI brut.

ErrorRate

Valeur codée qui représente une plage de pourcentages de taux d’erreur. Pour les appareils GSM, utilisez les valeurs de la colonne Taux d’erreur du canal dans le tableau suivant. Pour les appareils CDMA, utilisez les valeurs de la colonne Taux d’erreur frame. Dans les deux cas, utilisez WWAN_ERROR_RATE_UNKNOWN pour désigner un taux d’erreur inconnu.

Taux d’erreur du canal (en %) Taux d’erreur de trame (en %) Valeur codée (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
Inconnu ou indétectable WWAN_ERROR_RATE_UNKNOWN

RssiInterval

Intervalle actuel, en secondes, auquel le pilote miniport a été défini sur (ou l’intervalle par défaut, s’il n’en a pas été défini), auquel le pilote miniport fournit des mises à jour sur l’état du signal. Spécifiez WWAN_RSSI_DISABLE pour indiquer que le pilote miniport n’implémente pas de rapports basés sur des intervalles. Les pilotes miniport doivent renseigner ce membre avec l’intervalle en réponse à une demande antérieure du service Mo pour WWAN_RSSI_DEFAULT.

RssiThreshold

Seuil actuel, en unités de seuil, auquel le pilote miniport a été défini sur (ou l’intervalle par défaut, s’il n’en a pas été défini), auquel le pilote miniport fournit des mises à jour sur l’état du signal. Spécifiez WWAN_RSSI_DISABLE pour indiquer que le pilote miniport n’implémente pas de rapports basés sur les seuils. Les pilotes miniport doivent renseigner ce membre avec les unités de seuil en réponse à une demande antérieure du service Mo pour WWAN_RSSI_DEFAULT.

SignalStateListHeader

Une structure de WWAN_LIST_HEADER mise en forme qui représente une liste d’extensions d’état du signal par classe de données et le nombre de classes de données. Le pilote miniport doit retourner une liste de toutes les classes de données prises en charge.

Ce membre pointe vers une liste de structures WWAN_SIGNAL_STATE_EXT qui utilisent la structure WWAN_LIST_HEADER . Les autres membres des structures WWAN_SIGNAL_STATE_EX sont remplis en fonction de la classe de données la plus élevée disponible.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows 7 et versions ultérieures de Windows.
En-tête wwan.h (inclure Wwan.h)

Voir aussi

NDIS_WWAN_SIGNAL_STATE