IMbnSignal::GetSignalStrength-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 vom Gerät empfangene Signalstärke ab.
Syntax
HRESULT GetSignalStrength(
[out, retval] ULONG *signalStrength
);
Parameter
[out, retval] signalStrength
Zeiger auf die vom Gerät empfangene Signalqualität. Wenn die Signalstärke nicht bekannt ist oder vom Gerät nicht erkannt werden kann, wird dies auf MBN_RSSI_UNKNOWN festgelegt. Wenn diese Methode einen anderen Wert als S_OK zurückgibt, ist dieser Parameter 0.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
Die Signalqualität ist nicht verfügbar. Der mobile Breitbanddienst testiert derzeit das Gerät, um diese Informationen abzurufen. Wenn die Signalqualität verfügbar ist, ruft der Mobile Broadband-Dienst die OnSignalStateChange-Methode von IMbnSignalEvents auf. |
Hinweise
GetSignalStrength meldet die Signalstärke, die vom mobilen Breitbandgerät empfangen wird. Für GSM-basierte Geräte wird die Signalstärke als Signalstärke gemeldet, die in einem codierten Wert empfangen wird. Für CDMA-Geräte wird basierend auf dem Compensated RSSI (Compensated RSSI) und nicht basierend auf Raw RSSI gemeldet.
Die folgende Tabelle enthält die codierten Werte, die möglicherweise zurückgegeben werden.
| Signalstärke (in dBm) | Codierter Wert (Min: 0 Max: 31) |
|---|---|
| -113 oder weniger | 0 |
| -111 | 1 |
| -109 | 2 |
| ... | ... |
| ... | ... |
| -51 oder höher | 31 |
| Unbekannt oder nicht nachweisbar | MBN_RSSI_UNKNOWN |
Bei wiederherstellbaren Fehlern E_MBN_PIN_REQUIRED und E_MBN_RADIO_POWER_OFF fragt der mobile Breitbanddienst das Gerät erneut nach dem Signalzustand ab, wenn die Fehlerbedingung abgelaufen ist. Diese Methode gibt E_PENDING zurück, bis der Abfragevorgang abgeschlossen ist. Wenn die neue Abfrage abgeschlossen ist, ruft der Mobile Broadband-Dienst die OnSignalStateChange-Methode von IMbnSignalEvents auf.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | mbnapi.h |