User manual - WANGPRSライブラリマニュアルver.1.03(2012年3月29日)

34
3.3.15 WANGetRSSI, WanGetRssi
受信電波強度 RSSI(Received Signal Strength Indicator)を取得します。
[C++]
DWORD WANGetRSSI(
struct wan_RSSI * pRSSI
);
[Visual Basic]
Public Shared Function WanGetRssi(_
ByRef pRSSI As WanRssi _
) AS Int32
[C#]
static Int32 WanGetRssi(
out WanRssi pRSSI
);
解説
本関数は、受信電波強度 RSSI(Received Signal Strength Indicator)を取得します。
本関数を続けて使用する場合は、必ず 3 秒以上間隔を空けてください。
受信電波を検出できない場合は、wan_RSSI, WanRssi 構造体の nSignalStrength に
WAN_SIGNALSTRENGTH_UNKNOWN を格納します。
Device Emulator では、Operator.ini ファイルで指定した受信電波強度を取得します。詳細は、
Operator.iniを参照してください。
パラメータ
pRSSI
wan_RSSI, WanRssi 構造体を指定します。
戻り値
以下の値を返します。
WAN_ERROR_SUCCES
: 正常終了
WAN_ERROR_NOSIM
: SIM 未挿入
WAN_ERROR_MODULE_NOT_READY
: モジュール未準備（電源 OFF）
WAN_ERROR_BADPARAM
: パラメータエラー
WAN_ERROR_OPERATION_NOT_ALLOW
: 操作未許可エラー
WAN_ERROR_FAIL
: その他のエラー
DeviceEmulator では発生しません