OID_WWAN_DEVICE_CAPS_EX
OID_WWAN_DEVICE_CAPS_EX は OID_WWAN_DEVICE_CAPSと似ていますが、デバイス単位の OID である OID_WWAN_DEVICE_CAPS とは異なり、Executor 単位の OID です。 この OID は、LTE 接続 APN 構成などの拡張オプション機能の機能を含む、ハードウェアのデバイス/Executor 機能を示すために機能します。
ミニポート ドライバは、query 要求を非同期に処理する必要があります。最初に元の要求に対して NDIS_STATUS_INDICATION_REQUIRED を返し、その後、デバイスの機能に関する情報を提供するために、WWAN_DEVICE_CAPS_EX構造を含んだNDIS_WWAN_DEVICE_CAPS_EX 構造を含むNDIS_STATUS_WWAN_DEVICE_CAPS_EXステータス通知を送信します。
次の図は、query 要求を示しています。
set 要求は適用されません。
解説
ドライバーは、ドライバーから実際のデバイスを含めたサービス拡張機能の機能全体を報告することが重要です。 ドライバーがサービスをサポートしているが、基盤となるハードウェアでサポートされていない場合、サービス機能は FALSE としてマークされます。
OID_WWAN_DEVICE_CAPS_EX は、各 Executor の機能を取得するためにも使用されます。 この OID は、既存のOID_WWAN_DEVICE_CAPSと同じ構造ですが、Executor IDが追加されています。 ミニポート ドライバーは、サポートされている最も高い OID バージョンを報告する必要があります。
OID_WWAN_DEVICE_CAPSの場合と同様に、この OID のパラメーターは SIM カードが原因で変更されるのではなく、選択した Executor のモデムの RF 機能を表します。 物理ハードウェア モデムには複数の Executor があり、OID_WWAN_DEVICE_CAPS_EX をサポートする複数のインターフェイスがある場合があります。
将来の更新に備えて、OS の要求されたバージョンがデバイスでサポートされているバージョンより新しい場合、デバイスはサポートされている OID 構造の最新バージョンを返す必要があります。 OS の要求されたバージョンが、デバイスでサポートされている最新のバージョンよりも古い場合、デバイスは OS の仕様に一致するバージョンを返す必要があります。 IHV は、下位互換性と従来のサポートのために、OID_WWAN_DEVICE_CAPS_EX のすべてのリビジョンがサポートされていることを確認する必要があります。
モデムがマルチ SIM/マルチ Executor をサポートしている場合にのみ必要とされる Windows 10 Version 1703 の新しい他の OID とは異なり、この OID は、Windows 10 バージョン 1703 以降の Microsoft で定義されたサービス拡張機能をサポートするモデムに対して実装する必要があります。
Windows 10 バージョン 1703 より前のバージョンの Windows では、引き続き既存のOID_WWAN_DEVICE_CAPSが使用されている場合があります。マルチ Executor 対応モデムでの動作はサポート対象外です。 IHV はこの動作を定義する必要があります。
Windows 10 Version 1903
Windows 10 バージョン 1903 以降、OID_WWAN_DEVICE_CAPS_EX はリビジョン 2 にアップグレードされています。 ミニポート ドライバが 5G をサポートしている場合、ミニポート ドライバは、この OID のリビジョン 2 と、それに含まれるデータ構造を使用する必要があります。
ホストがこの OID を使用して機能を照会する場合、ミニポート ドライバーは基盤となるハードウェアが 5G 携帯ネットワーク機能をサポートしているかどうかをチェックする必要があります。 サポートしている場合、ミニポート ドライバーは、ハードウェアの機能に従って、WWAN_DEVICE_CAPS_EX構造体のWwanDataClassフィールドにビットマスクを設定します。
さらに、WWAN_DEVICE_CAPS_EX構造体のWwanOptionalServiceCapsフィールドでは、すべての新しい 5G 関連拡張機能のサポートをカバーする新しいオプションのサービス ビットが定義されます。
5G データ クラスのサポートの詳細については、MB の 5G データ クラスのサポートを参照してください。
要件
バージョン |
Windows 10 Version 1703 |
ヘッダー |
Ntddndis.h (Ndis.h を含む) |