OID_WWAN_SIGNAL_STATE

OID_WWAN_SIGNAL_STATE は、現在のシグナル状態を取得または設定します。

ミニポート ドライバーは、set 要求と query 要求を非同期的に処理する必要があります。最初は元の要求に対して NDIS_STATUS_INDICATION_REQUIRED を返し、後で、set 要求または query 要求の完了に関係なくエンドユーザに表示される現在の信号状態表示関する情報を提供するNDIS_WWAN_SIGNAL_STATE構造体を含むNDIS_STATUS_WWAN_SIGNAL_STATE状態通知を送信します。

現在のシグナル状態表示をエンド ユーザーに通知することを要求する場合、呼び出し元は適切な情報をミニポート ドライバーにNDIS_WWAN_SET_SIGNAL_INDICATION構造体を提供します。

解説

この OID の使用の詳細については、WWAN シグナル強度操作を参照してください。

query 操作または set 操作を処理する場合、ミニポート ドライバーはプロバイダー ネットワーク、または加入者識別モジュール (SIM カード) にアクセスできません。

一般に、ポーリングではなく信号状態を示す必要があります。 ただし、この OID は、現在のシグナル状態が MB サービスによって決定される必要がある場合に利用可能となります。

query 要求への応答の場合、ミニポート ドライバーは NDIS_STATUS_WWAN_SIGNAL_STATE 通知を送信します。

MB サービスからの set 要求の場合、ミニポート ドライバーは次に従う必要があります:

• ミニポート ドライバーで設定されているRssiIntervalとRssiThresholdの絶対値を報告するだけでなく、NDIS_WWAN_SIGNAL_STATE 構造体のRssiとErrorRateの現在の値を返します。

• デバイスが現在どのオペレーターにも登録されておらず、デバイスによってパラメーターの設定が登録後の状態にしかできない場合でも、RssiIntervalやRssiThreshold値は内部的にキャッシュされます。 ミニポート ドライバーは、次にすぐに使用できる状況でこれらの設定の適用を試行します。

• ハードウェアやソフトウェアの無線スイッチの状態が現在オフの場合、要求を正常に完了します。 ミニポート ドライバーは、要求データをキャッシュし、スイッチがオンになった後、信号強度の報告を開始します。

• この要求は、適切なuStatusエラー コードを設定して失敗させることができます。

ミニポート ドライバーは、MB サービスからの query 要求を処理するときに、次の操作を行うことができます:

• ミニポート ドライバーで設定されているRssiIntervalとRssiThresholdの絶対値を報告するだけでなく、NDIS_WWAN_SIGNAL_STATE 構造体のRssiとErrorRateの現在の値を返します。

• 適切なuStatusエラー コードを設定してこの要求を失敗させます。

戻り値:

NDIS_STATUS_NOT_SUPPORTED

特定のデバイスに対して、信号強度をサポートしていないデバイス機能を認識している場合、ミニポート ドライバーはこのエラーコードで要求を失敗させることができます。

推奨される実装

1. デバイスは信号強度表示をサポートする必要があります。

2. ドライバーは、5 分間に RssiInterval 設定の少なくとも 50% の信号強度表示を報告する必要があります。

3. デバイスは、次の状態では信号強度を報告しないようにする必要があります:

   1. デバイスは登録または登録解除されておらず、GSM デバイスにのみ適用されている。

   2. 無線の有効な状態がオフになっている。

   3. 上記の状態の場合、ミニポート ドライバーによって次のデータを使用して、信号強度に対する query に返答する必要があります:

      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 Version 1903

Windows 10 バージョン 1903 以降、OID_WWAN_SIGNAL_STATE はリビジョン 3 にアップグレードされています。 このリビジョンにより、ホストは、ミニポート ドライバーからの新しい基準信号受信電力 (RSRP) と 信号対雑音比 (SNR) の値を照会できます。 ミニポート ドライバーは、この OID のリビジョン 3 と、ドライバーが 5G をサポートしている場合、そのデータ構造を使用する必要があります。

5G データ クラスのサポートの詳細については、MB の 5G データ クラスのサポートを参照してください。

要件

関連項目

NDIS_WWAN_SET_SIGNAL_INDICATION

WWAN 信号強度操作