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 為 WwanCellularClassGSMWwanCellularClassCDMA 的迷你埠驅動程式,必須在裝置的敏感度雜訊底板上方回報 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)

另請參閱

NDIS_WWAN_SIGNAL_STATE