次の方法で共有

OID_WWAN_CONNECT

  • [アーティクル]

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

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

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

備考

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

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

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

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

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

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

この OID のデータ構造はNDIS_WWAN_SET_CONTEXT_STATE。 ミニポート ドライバーは、セット要求とクエリ要求の両方のNDIS_STATUS_WWAN_CONTEXT_STATEの状態を示します。

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

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

このバージョンではアクティブ化されたコンテキストが 1 つしかサポートされていないので、特定のコンテキストをアクティブ化または非アクティブ化すると、レイヤー 2 MB の接続を設定または破棄する必要があります。

セット要求では、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を返します。

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

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

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

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

クエリ要求への応答のために、ミニポート ドライバーはNDIS_STATUS_WWAN_CONTEXT_STATE通知を送信します。

重要な 注:

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

必要条件

バージョン

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

ヘッダ

 Ntddndis.h (Ndis.h を含む)

関連項目

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