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
特定のデバイスに対して、信号強度をサポートしていないデバイス機能を認識している場合、ミニポート ドライバーはこのエラーコードで要求を失敗させることができます。
推奨される実装
デバイスは信号強度表示をサポートする必要があります。
ドライバーは、5 分間に RssiInterval 設定の少なくとも 50% の信号強度表示を報告する必要があります。
デバイスは、次の状態では信号強度を報告しないようにする必要があります:
デバイスは登録または登録解除されておらず、GSM デバイスにのみ適用されている。
無線の有効な状態がオフになっている。
上記の状態の場合、ミニポート ドライバーによって次のデータを使用して、信号強度に対する 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 データ クラスのサポートを参照してください。
要件
バージョン |
Windows 7 以降のバージョンの Windows で使用できます。 |
ヘッダー |
Ntddndis.h (Ndis.h を含む) |