WWAN_SIGNAL_STATE構造体 (wwan.h)

WWAN_SIGNAL_STATE構造体は、MB デバイスのシグナル状態を表します。

構文

typedef struct _WWAN_SIGNAL_STATE {
  ULONG            Rssi;
  ULONG            ErrorRate;
  ULONG            RssiInterval;
  ULONG            RssiThreshold;
  WWAN_LIST_HEADER SignalStateListHeader;
} WWAN_SIGNAL_STATE, *PWWAN_SIGNAL_STATE;

メンバー

Rssi

ワイヤレス信号の強度を表す 値。 WwanCellularClassGSM または WwanCellularClassCDMA であるWWAN_CELLULAR_CLASSを報告するミニポート ドライバーは、デバイスの秘密度ノイズ フロアの上にあるデシベルで Rssi を報告する必要があります。

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

CDMA ベースのデバイスでは、生の RSSI に基づくのではなく、補正された RSSI (ノイズを考慮) に基づいて信号強度を報告する必要があります。

ErrorRate

エラー 率のパーセンテージ範囲を表すコード化された値。 GSM ベースのデバイスの場合は、次の表の [チャネル ビット エラー 率] 列の値を使用します。 CDMA ベースのデバイスの場合は、[フレーム エラー率] 列の値を使用します。 どちらの場合も、WWAN_ERROR_RATE_UNKNOWNを使用して不明なエラー率を示します。

チャネル ビット エラー 率 (%) フレーム エラー率 (%) コード化された値 (Min=0、Max=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
- 3.2 1.0 - -2.0 4
- 6.4 2.0-4.0 5
6.4-12.8 4.0-8.0 6
> 12.8 > 8.0 7
不明または検出できない WWAN_ERROR_RATE_UNKNOWN

RssiInterval

ミニポート ドライバーが (または既定の間隔が設定されていない場合) に設定されている現在の間隔 (秒単位) は、ミニポート ドライバーがシグナル状態に関する更新プログラムを提供します。 ミニポート ドライバーが間隔ベースのレポートを実装しないことを示すWWAN_RSSI_DISABLEを指定します。 ミニポート ドライバーは、WWAN_RSSI_DEFAULTの MB サービスからの以前の要求に応答して、このメンバーに間隔を設定する必要があります。

RssiThreshold

ミニポート ドライバーが に設定されている現在のしきい値 (しきい値単位) (または既定の間隔が設定されていない場合) は、ミニポート ドライバーがシグナル状態に関する更新プログラムを提供します。 ミニポート ドライバーがしきい値ベースのレポートを実装しないことを示すWWAN_RSSI_DISABLEを指定します。 ミニポート ドライバーは、WWAN_RSSI_DEFAULTの MB サービスからの以前の要求に応答して、しきい値ユニットをこのメンバーに設定する必要があります。

SignalStateListHeader

データ クラスごとのシグナル状態拡張の一覧とデータ クラスの数を表す書式設定された WWAN_LIST_HEADER 構造体。 ミニポート ドライバーは、サポートされているすべてのデータ クラスの一覧を返す必要があります。

このメンバーは、 WWAN_LIST_HEADER構造体を 使用するWWAN_SIGNAL_STATE_EXT 構造体の 一覧を指します。 WWAN_SIGNAL_STATE_EX構造体の残りのメンバーは、使用可能な最高のデータ クラスに基づいて塗りつぶされます。

要件

要件
サポートされている最小のクライアント Windows 7 以降のバージョンの Windows で使用できます。
Header wwan.h (Wwan.h を含む)

こちらもご覧ください

NDIS_WWAN_SIGNAL_STATE