共用方式為

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 服務的集合要求上，迷你埠驅動程式應該：

  • 除了報告已在迷你埠驅動程式中設定的RssiInterval和RssiThreshold絕對值之外，傳回 NDIS_WWAN_SIGNAL_STATE 結構中的目前 Rssi和ErrorRate值。

  • 在內部快取 RssiInterval 和/或 RssiThreshold 值，即使裝置目前未向任何操作員註冊，且裝置在設定參數中加加的任何限制只能是註冊後狀態。 迷你埠驅動程式應該嘗試在下一個立即可用的情況下套用這些設定。

  • 如果硬體和/或軟體無線電交換器狀態目前為 OFF，請順利完成要求。 迷你埠驅動程式會快取要求資料，並開始在開關開啟之後報告訊號強度。

  • 此要求可能會失敗，並設定適當的 uStatus 錯誤碼。

當處理來自 MB 服務的查詢要求時，迷你埠驅動程式可以執行下列動作：

  • 除了報告已在迷你埠驅動程式中設定的RssiInterval和RssiThreshold絕對值之外，傳回 NDIS_WWAN_SIGNAL_STATE 結構中的目前 Rssi和ErrorRate值。

  • 此要求失敗，並設定適當的 uStatus 錯誤碼。

傳回值：

NDIS_STATUS_NOT_SUPPORTED

迷你埠驅動程式可以針對不支援訊號強度的特定裝置傳回這項功能，可能會因為這個錯誤碼而失敗要求。

建議的實作

  1. 裝置必須支援訊號強度指示。

  2. 驅動程式必須報告至少 50% 的 RssiInterval 設定在五分鐘內的訊號強度指示。

  3. 裝置必須避免報告下列狀態的訊號強度：

    1. 裝置未註冊或取消註冊，僅適用于 GSM 裝置。

    2. 無線電的有效狀態為 OFF。

    3. 在上述狀態中，迷你埠驅動程式必須以下列資料傳回訊號強度的查詢：

      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) 和訊號對雜訊 (SNR) 值。 如果驅動程式支援 5G，迷你埠驅動程式必須使用此 OID 的修訂 3 及其資料結構。

如需 5G 資料類別支援的詳細資訊，請參閱 MB 5G 資料類別支援。

規格需求

版本

可在 Windows 7 和更新版本的 Windows 中使用。

標頭

 Ntddndis.h (包括 Ndis.h)

另請參閱

NDIS_WWAN_SET_SIGNAL_INDICATION

WWAN 訊號強度作業