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

  • [アーティクル]

重要

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

受信シグナル エラー率を取得します。

構文

HRESULT GetSignalError(
  [out, retval] ULONG *signalError
);

パラメーター

[out, retval] signalError

受信したシグナルのエラー率へのポインター。

モバイル ブロードバンド インターフェイスは、信号エラー率を、エラー率の割合範囲にマップするコード化された値として報告します。 これは、GSM のチャネル ビット エラー レートと CDMA のフレーム エラー レートです。 どちらの場合も、MBN_ERROR_RATE_UNKNOWNは不明なエラー率を指定します。

次の表は、エラー 率コードの値を示しています。

ビット エラー 率 (%) フレーム エラー率 (%) コード化された値 (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

戻り値

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

リターン コード 説明
S_OK
 メソッドが正常に完了しました

.
E_PENDING
 エラー率はまだ使用できません。 モバイル ブロードバンド サービスは現在、デバイスをプローブして情報を取得しています。 エラー率が使用可能になると、モバイル ブロードバンド サービスは IMbnSignalEvents の OnSignalStateChange メソッドを呼び出します。

注釈

モバイル ブロードバンド インターフェイスは、信号エラー率を、誤差率のパーセンテージ範囲にマップするコード化された値として報告します。 これは、GSM のチャネル ビット エラー レートと CDMA のフレーム エラー レートです。 どちらの場合も、 MBN_ERROR_RATE_UNKNOWN は不明なエラー率を指定します。

要件

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

こちらもご覧ください

IMbnSignal