IMbnSignal::GetSignalError-Methode (mbnapi.h)
Wichtig
Ab Windows 10 Version 1803 werden die in diesem Abschnitt beschriebenen Win32-APIs durch die Windows-Runtime-APIs im Windows.Networking.Connectivity-Namespace ersetzt.
Ruft die Empfangene Signalfehlerrate ab.
Syntax
HRESULT GetSignalError(
[out, retval] ULONG *signalError
);
Parameter
[out, retval] signalError
Zeiger auf die Fehlerrate im empfangenen Signal.
Mobile Breitbandschnittstellen melden die Signalfehlerrate als codierten Wert, der dem prozentualen Bereich der Fehlerraten zugeordnet ist. Dies ist die Kanalbitfehlerrate für GSM und die Frame Error Rate für CDMA. In beiden Fällen gibt MBN_ERROR_RATE_UNKNOWN eine unbekannte Fehlerrate an.
In der folgenden Tabelle sind die Werte für die Fehlerratencodes aufgeführt.
| Bitfehlerrate (in %) | Framefehlerrate (in %) | Codierter Wert (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 |
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen . |
|
Die Fehlerrate ist noch nicht verfügbar. Der mobile Breitbanddienst testiert derzeit das Gerät, um die Informationen abzurufen. Wenn die Fehlerrate verfügbar ist, ruft der Mobile Broadband-Dienst die OnSignalStateChange-Methode von IMbnSignalEvents auf. |
Hinweise
Mobile Breitbandschnittstellen melden die Signalfehlerrate als codierten Wert, der einem prozentualen Bereich der Fehlerraten zugeordnet ist. Dies ist die Kanalbitfehlerrate für GSM und die Frame Error Rate für CDMA. Für beide Fälle gibt MBN_ERROR_RATE_UNKNOWN eine unbekannte Fehlerrate an.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | mbnapi.h |