OID_WWAN_CONNECT

  • [アーティクル]

OID_WWAN_CONNECT は、特定のパケット コンテキストをアクティブ化または非アクティブ化し、コンテキストのアクティブ化状態を読み取ります。

ミニポート ドライバーは、セットとクエリの要求を非同期的に処理する必要があります。最初は元の要求に対して NDIS_STATUS_INDICATION_REQUIRED を返し、後で、set 要求または query 要求の完了に関係なく、MB デバイスのパケット データ プロトコル (PDP) コンテキスト状態を示すNDIS_WWAN_CONTEXT_STATE構造を含むNDIS_STATUS_WWAN_CONTEXT_STATE状態通知を送信する必要があります。

MB デバイスのパケット データ プロトコル (PDP) コンテキスト状態の設定を要求する呼び出し元は、適切な情報を使用してミニポート ドライバーにNDIS_WWAN_SET_CONTEXT_STATE構造体を提供します。

解説

この OID の使用方法の詳細については、WWAN パケット コンテキスト管理を参照してください。

このオブジェクトは、特定のパケット コンテキストをアクティブ化または非アクティブ化し、コンテキストのアクティブ化状態を読み取ります。 ミニポート ドライバーは、アクティブ化の状態が変更されるたびに、適切なイベント通知を送信する必要があります。

このオブジェクトは、ミニポート ドライバーが WwanRegisterStateHome、WwanRegisterStatePartner、またはWwanRegisterStateRoamingの登録状態にある場合にのみ呼び出されます。 パケット サービスがアクティブな場合、デバイスの接続状態もWwanPacketServiceStateAttachedである必要があります。

このオブジェクトでは、set 操作と query 操作の両方がサポートされています。

  • set 要求の処理にはネットワーク アクセスが必要ですが、SIM アクセスは必要ありません。

  • query 要求の処理には、ネットワークまたは SIM へのアクセスは必要ありません。

この OID のデータ構造は NDIS_WWAN_SET_CONTEXT_STATE です。 ミニポート ドライバは、set 要求と query 要求の両方に対して、NDIS_STATUS_WWAN_CONTEXT_STATE のステータス表示を発行します。

このバージョンのドライバー モデルでは、ミニポート ドライバーは、MB サービスの指示に従ってのみコンテキストのアクティブ化を試みます。 (ミニポート ドライバーは、新しいバージョンでネットワークによって開始されたコンテキストをアクティブ化することができます。)ミニポート ドライバーは、登録や信号を失った後でも、コンテキストを自動的にアクティブ化することはできません。 ミニポート ドライバーは、アクティブ化要求にアクセス文字列が指定されていない場合、既定の文字列を提供することはできません。 代わりに、空のアクセス文字列を使用してコンテキストをアクティブ化する必要があります。

これに対し、ミニポート ドライバーは、MB サービスの指示に従ってコンテキストを非アクティブ化することがあります。 これは、一時的な信号損失のしきい値を超える期間ネットワーク接続が失われた場合、または正常なシャットダウンまたは状態のクリーンアップの一環として発生する可能性があります。

このバージョンではアクティブ化されたコンテキストが 1 つしかサポートされていないため、特定のコンテキストのアクティブ化または非アクティブ化は、レイヤ2の MB 接続の確立または切断に相当します。

set 要求では、MB サービスは、WWAN_CONTEXT_STATE データ構造のConnectionIdとActivationCommandの両方のパラメーターを提供します。 これは、ActivationCommandパラメーター値WwanActivationCommandActivateまたはWwanActivationCommandDeactivateを基に、ConnectionIdで識別されるパケット コンテキストをアクティブ化または非アクティブ化するようにミニポート ドライバーに指示します。

  • サービスまたはサブスクリプションでアクティブ化が必要な場合、ミニポート ドライバーはエラー コード WWAN_STATUS_SERVICE_NOT_ACTIVATED を返します。 PDP ライセンス認証は、サービスまたはサブスクリプションがアクティブ化されるまで発生しない可能性があります。 すべての緊急サービスは、デバイスとオペレーターからのサポートの対象となる場合があります。 オペレーティング システムは、このエラー コードに応答して OID_WWAN_SERVICE_ACTIVATION を呼び出す場合があります。

  • 別のパケット コンテキストが現在アクティブ化されている間にミニポート ドライバーがコンテキストのアクティブ化要求を受信した場合、エラー コード WWAN_STATUS_MAX_ACTIVATED_CONTEXTS を返します。

  • ミニポート ドライバーがコンテキストの非アクティブ化要求を受信したが、ConnectionIdによって識別されるコンテキストが現在アクティブ化されていない場合、エラーコード WWAN_STATUS_CONTEXT_NOT_ACTIVATED を返します。

ミニポート ドライバーは、次のロジックを使用して、set 要求からの AccessString、UserName、およびパスワードの設定の有効性を判断します。

  • ActivationCommandがWwanActivationCommandDeactivateの場合、ミニポート ドライバーはこれら 3 つのパラメーターの設定を無視する必要があります。 それ以外のケースでは、ActivationCommandがWwanActivationCommandActivateの場合にのみ考慮されます。

コンテキストのアクティブ化は、ユーザーのログオンとログオフの間保持されます。 これはログオン ユーザーごとではありません。

query 要求では、MB サービスはこのオブジェクトを使用してアクティブ化の状態を確認します。

ミニポート ドライバーは query 要求への応答として NDIS_STATUS_WWAN_CONTEXT_STATE 通知を送信します。

重要な注意:

まれに、特定の状況で、Windows 7 の MB サービスが、既存の接続についてインターネットへの接続が決定される前に、または既存の接続のインターネット接続が一時的に中断されている間に、自動接続を試みることがあります。 これにより、MB と WLAN/イーサネット接続が同時に発生する可能性があります。 例として、これは、システムの起動中に、MB とその他の接続が同時に試行され、ネットワーク リスト マネージャー サービスがアクティブおよびパッシブの方法を使用して他の接続のインターネット接続を確認しようとしている場合に発生する可能性があります。 また、企業プロキシ サーバーや ISP ネットワークなどのネットワーク インフラストラクチャの一時的な停止が原因で発生する可能性もあります。 したがって、MB サービスは、「利用可能な代替インターネット接続がない場合にのみ自動接続する」オプションが選択されているかどうかに関係なく、インターネットへの自動接続を試行することがあります。

要件

バージョン

Windows 7 以降のバージョンの Windows で使用できます。

ヘッダー

 Ntddndis.h (Ndis.h を含む)

関連項目

WWAN パケット コンテキスト管理