OID_WWAN_RADIO_STATE
OID_WWAN_RADIO_STATE は、MB デバイスの無線電源状態に関する情報を設定または返します。
ミニポート ドライバーは、セットとクエリの要求を非同期的に処理する必要があります。最初は元の要求に対して NDIS_STATUS_INDICATION_REQUIRED を返し、後で、set 要求または query 要求の完了に関係なく、MB デバイスの現在の無線電力状態を示すNDIS_WWAN_RADIO_STATE構造を含む>NDIS_STATUS_WWAN_RADIO_STATE状態通知を送信する必要があります。
MB デバイスの無線電源状態の設定を要求する呼び出し元は、ミニポート ドライバーに適切な情報とともにNDIS_WWAN_SET_RADIO_STATE構造体を提供します。
解説
この OID の使用方法の詳細については、MB 無線状態を参照してください。
query 操作または set 操作を処理する場合、ミニポート ドライバーはプロバイダー ネットワーク、または加入者識別モジュール (SIM カード) にアクセスできません。
ミニポート ドライバーは、システムの再起動またはデバイスの取り外しと再挿入の間でソフトウェア無線電源の状態を保持する必要があります。 ミニポート ドライバーは、デバイスのソフトウェア無線情報を保存する必要があります。この情報を使用して、デバイスは再起動または挿入の都度、即座にデバイスのソフトウェア無線電源状態を設定します。 デバイスの有効な無線電源状態は、ソフトウェアとハードウェアの無線電源状態の組み合わせを基に、WWAN_RADIO_STATEのテーブルに従い決定されます。
値が WwanRadioOn の場合、ミニポート ドライバーは無線電源をオンにし、WWAN_RADIO_STATE構造体の RadioState.SwRadioState メンバーを WwanRadioOn に設定する必要があります。 RadioState.HwRadioState メンバーが WwanRadioOff であった場合、ミニポート ドライバーは、この電源状態情報をキャッシュし、RadioState.HwRadioState が WwanRadioOn に変更されたときに、無線の電源状態を物理的にオンにする必要があります。
値が WwanRadioOff の場合、ミニポート ドライバーは無線電源状態をオフにし、RadioState.SwRadioState メンバーを WwanRadioOff に設定する必要があります。
ミニポート ドライバーによる想定される無線状態のプログラミングについては、次の表を参照してください。
PIN モードと PIN 状態の有効な組み合わせ
| HwRadioState 値 | SwRadioState 値 | 全体的な無線電源の状態 |
|---|---|---|
WwanRadioOff |
WwanRadioOff |
WwanRadioOff |
WwanRadioOff |
WwanRadioOn |
WwanRadioOff |
WwanRadioOn |
WwanRadioOff |
WwanRadioOff |
WwanRadioOn |
WwanRadioOn |
WwanRadioOn |
ハードウェア無線電源スイッチを提供しないデバイスの場合、NDIS_WWAN_RADIO_STATE 構造体のRadioState.HwRadioStateンバーは常にWwanRadioOnに設定する必要があります。
Windows 10 バージョン 1703 以降、OID_WWAN_RADIO_STATE には、マルチ Executor をサポートするモデムが OS からの無線状態構成を処理する方法に関する仕様が追加されています。
マルチ Executor でサポートされるモデムでは、Executor ごとに無線の電源状態を構成することで電力上の利点があります。 Executor の無線がオフになっている場合、OS はモデムがネットワークから登録を解除することを想定し、そこからスキャンや場所の更新を試みません。 モデムは、ハードウェアの電源状態を判断できるように、OS に通知する各 Executor の無線状態をサポートする必要があります。
例えば、モデムに 2 つの Executor があり、片方 Executor の無線がオンになっていてもう片方の Executor の無線がオフになっている場合、モデムはオフになっている Executor の登録を維持するために RF フロントエンドの電源を入れたままにすることができますが、オフになっている Executor のスキャン、ping、ロケーションの更新、またはその他の携帯電話サービスを行う必要はありません。 両方の無線をオフにした場合、モデムは RF フロントエンドをオフにして、ハードウェア全体を低電力状態にすることができます。 実装の詳細は、各 IHV に任されています。
要件
バージョン |
Windows 7 以降のバージョンの Windows で使用できます。 |
ヘッダー |
Ntddndis.h (Ndis.h を含む) |