IMbnSignal ::GetSignalError, méthode (mbnapi.h)
Important
À compter de Windows 10, version 1803, les API Win32 décrites dans cette section sont remplacées par les API Windows Runtime dans l’espace de noms Windows.Networking.Connectivity.
Obtient le taux d’erreur du signal reçu.
Syntaxe
HRESULT GetSignalError(
[out, retval] ULONG *signalError
);
Paramètres
[out, retval] signalError
Pointeur vers le taux d’erreur dans le signal reçu.
Les interfaces haut débit mobiles signalent le taux d’erreur de signal sous la forme d’une valeur codée qui correspond à la plage de pourcentage des taux d’erreur. Il s’agit du taux d’erreur binaire du canal pour GSM et du taux d’erreur de trame pour CDMA. Dans les deux cas, MBN_ERROR_RATE_UNKNOWN spécifie un taux d’erreur inconnu.
Le tableau suivant présente les valeurs des codes de taux d’erreur.
| Taux d’erreur binaire (en %) | Taux d’erreur de trame (en %) | Valeur codée (0-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 |
| 1.6 - 3.2 | 1.0 - 2.0 | 4 |
| 3.2 - 6.4 | 2.0 - 4.0 | 5 |
| 6.4 - 12.8 | 4.0 - 8.0 | 6 |
| > 12.8 | > 8.0 | 7 |
| unknown | unknown | MBN_ERROR_RATE_UNKNOWN |
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
|
La méthode s’est terminée avec succès . |
|
Le taux d’erreur n’est pas encore disponible. Le service Haut débit mobile est en cours de sonder l’appareil pour récupérer les informations. Lorsque le taux d’erreur est disponible, le service haut débit mobile appelle la méthode OnSignalStateChange de IMbnSignalEvents. |
Remarques
Les interfaces haut débit mobile signalent le taux d’erreur de signal sous la forme d’une valeur codée qui correspond à une plage de pourcentages de taux d’erreur. Il s’agit du taux d’erreur binaire du canal pour GSM et du taux d’erreur de trame pour CDMA. Pour les deux cas, MBN_ERROR_RATE_UNKNOWN spécifie un taux d’erreur inconnu.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Aucun pris en charge |
| Plateforme cible | Windows |
| En-tête | mbnapi.h |