IMbnSignal::GetSignalStrength メソッド (mbnapi.h)

  • [アーティクル]

重要

バージョン 1803 Windows 10以降、このセクションで説明する Win32 API は、Windows.Networking.Connectivity 名前空間のWindows 运行时 API に置き換えられます。

デバイスが受信した信号強度を取得します。

構文

HRESULT GetSignalStrength(
  [out, retval] ULONG *signalStrength
);

パラメーター

[out, retval] signalStrength

デバイスが受信した信号品質へのポインター。 信号強度が不明な場合、またはデバイスで検出できない場合は、 MBN_RSSI_UNKNOWNに設定されます。 このメソッドが S_OK 以外の値を返す場合、このパラメーターは 0 です。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード 説明
S_OK
 メソッドは正常に完了しました。
E_PENDING
 信号品質は使用できません。 モバイル ブロードバンド サービスは現在、この情報を取得するためにデバイスをプローブしています。 信号品質が使用可能になると、モバイル ブロードバンド サービスは IMbnSignalEvents の OnSignalStateChange メソッドを呼び出します。

解説

GetSignalStrength は、モバイル ブロードバンド デバイスによって受信された信号強度を報告します。 GSM ベースのデバイスの場合、信号強度は、コード化された値で受信された信号強度として報告されます。 CDMA デバイスの場合、生 RSSI に基づくのではなく、補正 RSSI (ノイズを考慮) に基づいて報告されます。

次の表に、返される可能性があるコード化された値を示します。

信号強度 (dBm 単位) コード化された値 (最小: 0 最大: 31)
-113 以下 0
-111 1
-109 2
... ...
... ...
-51 以上 31
不明または検出できない MBN_RSSI_UNKNOWN
 

回復可能なエラー E_MBN_PIN_REQUIREDと E_MBN_RADIO_POWER_OFFの場合、モバイル ブロードバンド サービスは、エラー状態が過ぎたときの信号状態についてデバイスに対して再度クエリを実行します。 このメソッドは、クエリ操作が完了するまでE_PENDINGを返します。 新しいクエリが完了すると、モバイル ブロードバンド サービスは IMbnSignalEvents の OnSignalStateChange メソッドを呼び出します。

要件

   
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー mbnapi.h

関連項目

IMbnSignal