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 で使用できます。 |
ヘッダー | wwan.h (Wwan.h を含む) |