structure WWAN_SIGNAL_STATE (wwan.h)
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) |