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 為單位) | 自動程式代碼值 (最小值=0,最大值=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,指出迷你埠驅動程式不會實作以間隔為基礎的報告。 迷你埠驅動程序應該以間隔填入此成員,以回應先前從 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) |