OID_WWAN_SIGNAL_STATE
OID_WWAN_SIGNAL_STATE會傳回或設定目前的訊號狀態。
迷你埠驅動程序必須以異步方式處理設定和查詢要求,一開始將NDIS_STATUS_INDICATION_REQUIRED傳回至原始要求,然後傳送包含 NDIS_WWAN_SIGNAL_STATE 結構 NDIS_STATUS_WWAN_SIGNAL_STATE 狀態通知,以提供目前向用戶顯示之訊號狀態指示的相關信息,而不論完成設定或查詢要求為何。
要求將目前訊號狀態指示設定給終端使用者的來電者會提供 NDIS_WWAN_SET_SIGNAL_INDICATION 結構給迷你埠驅動程式,並提供適當的資訊。
言論
如需使用此 OID 的詳細資訊,請參閱 WWAN 訊號強度作業。
處理查詢或設定作業時,迷你埠驅動程式不應該存取提供者網路或訂閱者識別模組(SIM 卡)。
一般而言,應該指出訊號狀態,而不是輪詢。 不過,如果目前的訊號狀態需要由 MB 服務決定,就會提供此 OID。
若要回應查詢要求,迷你埠驅動程式應該傳送NDIS_STATUS_WWAN_SIGNAL_STATE通知。
在 MB 服務的設定要求上,迷你埠驅動程式應:
傳回 NDIS_WWAN_SIGNAL_STATE 結構中 Rssi 和 ErrorRate 的目前值,除了報告 RssiInterval 和 已在迷你埠驅動程式中設定的 RssiThreshold 絕對值。
在內部快取 RssiInterval 和/或 RssiThreshold 值,即使裝置目前未向任何作員註冊,而且裝置在設定參數中加設的任何限制只能是註冊后狀態。 迷你埠驅動程式應該嘗試在下一個立即可用的情況下套用這些設定。
如果硬體和/或軟體無線電交換器狀態目前為 OFF,請順利完成要求。 迷你埠驅動程式會快取要求數據,並開始在開關開啟之後報告訊號強度。
此要求可能會失敗,並設定適當的 uStatus 錯誤碼。
處理來自 MB 服務的查詢要求時,迷你埠驅動程式可以執行下列動作:
傳回 NDIS_WWAN_SIGNAL_STATE 結構中 Rssi 和 ErrorRate 的目前值,除了報告 RssiInterval 和 已在迷你埠驅動程式中設定的 RssiThreshold 絕對值。
請以適當的 uStatus 錯誤碼集,使此要求失敗。
傳回值:
NDIS_STATUS_NOT_SUPPORTED
迷你埠驅動程式可以針對特定裝置傳回這個值,這些裝置知道不支援訊號強度的裝置功能可能會因為這個錯誤碼而失敗。
建議實作
裝置必須支援訊號強度指示。
司機必須報告至少 50 個% RssiInterval 在 5 分鐘內設定的訊號強度指示。
裝置必須避免在下列狀態中報告訊號強度:
裝置未註冊或取消註冊,僅適用於 GSM 裝置。
無線電的有效狀態為 OFF。
在上述狀態中,迷你埠驅動程序必須以下列數據傳回訊號強度的查詢:
Rssi = WWAN_RSSI_UNKNOWN
ErrorRate = WWAN_ERROR_RATE_UNKNOWN;
RssiInterval = < WWAN_RSSI_DISABLE、WWAN_RSSI_DEFAULT或最後一個設定值>
RssiThreshold = < WWAN_RSSI_DISABLE、WWAN_RSSI_DEFAULT或最後一個設定值>
Windows 10 版本 1903
從 Windows 10 版本 1903 開始,OID_WWAN_SIGNAL_STATE已升級至修訂 3。 此修訂可讓主機從迷你埠驅動程序查詢新的參考訊號接收電源 (RSRP) 和 Signal-to-Noise (SNR) 值。 如果驅動程序支援 5G,迷你埠驅動程式必須使用此 OID 的修訂 3 及其數據結構。
如需 5G 資料類別支援的詳細資訊,請參閱 MB 5G 資料類別支援。
要求
版本 |
適用於 Windows 7 和更新版本的 Windows。 |
頁眉 |
Ntddndis.h (包括 Ndis.h) |