SmsGetSignalStrength
value SmsGetSignalStrength ( value BYREF StrengthInDecibelMilliWatt = NULL );
Rückgabewert
Rückgabewert |
Beschreibung |
-1 |
Die Signalstärke konnte nicht ermittelt werden, da kein GSM-fähiges Modem gefunden wurde. |
0 |
Kein
oder ein extrem schwaches Signal. Es werden wahrscheinlich keine
Nachrichten per GSM zu versenden sein. |
1 |
Schwaches
Signal. |
2 |
Gutes Signal. StrengthInDecibelMilliWatt < -83 dBm |
3 |
Sehr gutes Signal StrengthInDecibelMilliWatt < -73 dBm |
4 |
Hervorragendes Signal StrengthInDecibelMilliWatt >= -73 dBm |
Parameter
StrengthInDecibelMilliWatt
Die Funksignalstärke in dBm.
Bemerkung
Ermittelt die Qualität der Funksignalstärke des GSM-Modems
und übergibt den dBm-Wert nach StrengthInDecibelMilliWatt.
Wird diese Funktion aufgerufen, so wird alle zwei Sekunden die Signalstärke
am GSM-Modem abgefragt. Wird kein GSM-Modem gefunden, so ist das Ergebnis
-1 und es wird alle zwei Minuten nach einem GSM-fähigen Modem gesucht.
Beispiele
Soll die Signalstärke oder das Fehlen des GSM-Modems als Bild dargestellt werden, so sollten z.B. nachfolgende Bilder im Bilderordner vorhanden sein.
Bild |
Dateiname |
signal_-1.png |
|
signal_0.png |
|
signal_1.png |
|
signal_2.png |
|
signal_3.png |
|
signal_4.png |
Der nachfolgende Programmcode erzeugt, mit Hilfe des Rückgabewerts von SmsGetSignalStrength, einen Dateinamen der einem der obigen Bildern entspricht.
//_MainCycle // //////////////////////////////////////////////////////////////////////strSignalStrengthImage = Printf("signal_%d.png", SmsGetSignalStrength());
Wird dann in einem Bild-Bauelement als Datei die Variable strSignalStrengthImage angegeben, die Eigenschaft Anpassen auf 'Strecken/Stauchen möglich' und die Größe auf hier 32x32 Pixel gestellt, so zeigt dieses Bauelement immer den Zustand bzw. die Signalqualität des angeschlossenen GSM-Modems an.
Allgemeines zu den Pagerdiensten
Siehe auch PagerSetDevice, PagerCancelAllMessages, PagerGetDevice, PagerGetDeviceList, PagerGetPendingMessage, SmsGetOnErrorDelayTime, SmsGetSendMessageTimeout, SmsSend, SmsSetOnErrorDelayTime, SmsSetSendMessageTimeout