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
值，表示無線訊號的強度。 回報其WWAN_CELLULAR_CLASS 為 WwanCellularClassGSM 或 WwanCellularClassCDMA 的迷你埠驅動程式，必須在裝置的敏感度雜訊底板上方回報 Rssi。
| dBm) 中的訊號強度 ( | Coded Value (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 來表示未知的錯誤率。
| %) 中的通道位錯誤率 ( | %) 中的幀錯誤率 ( | Coded value (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，指出迷你埠驅動程式不會實作以間隔為基礎的報告。 迷你埠驅動程序應該會以間隔填入此成員，以回應來自 MB 服務WWAN_RSSI_DEFAULT的先前要求。
RssiThreshold
目前的臨界值，以臨界值單位為單位，迷你埠驅動程式已設定為 (或預設間隔，如果尚未設定) ，迷你埠驅動程式就會提供訊號狀態的更新。 指定WWAN_RSSI_DISABLE，指出迷你埠驅動程式不會實作臨界值型報告。 迷你埠驅動程式應以閾值單位填入此成員，以回應來自 MB 服務WWAN_RSSI_DEFAULT的先前要求。
SignalStateListHeader
格式化 WWAN_LIST_HEADER 結構，代表每個數據類別的訊號狀態延伸模組清單和數據類別數目。 迷你埠驅動程序必須傳回所有支援的數據類別清單。
這個成員指向使用 WWAN_LIST_HEADER 結構的WWAN_SIGNAL_STATE_EXT結構清單。 WWAN_SIGNAL_STATE_EX 結構的其餘 成員會根據最高的可用數據類別來填入。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows 7 和更新版本的 Windows。 |
| 標頭 | wwan.h (包含 Wwan.h) |