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 を含む) |