OID_WWAN_PROVISIONED_CONTEXTS、MB デバイスまたはサブスクライバー ID モジュール (SIM) に格納されているプロビジョニング済みコンテキスト エントリを読み取りまたは更新します。
ミニポート ドライバーは、セットとクエリの要求を非同期的に処理し、最初は元の要求にNDIS_STATUS_INDICATION_REQUIREDを返し、後で、セットまたはクエリ要求の完了に関係なく、MB デバイスまたはサブスクライバー ID モジュール (SIM) に格納されているプロビジョニングされたコンテキスト エントリに関する情報を提供する NDIS_WWAN_PROVISIONED_CONTEXTS 構造を含む NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS 状態通知を送信する必要があります。
備考
この OID の使用の詳細については、「WWAN パケット コンテキスト管理 を参照してください。
ミニポート ドライバーは、サポートする MB デバイスがプロビジョニングされたコンテキストの取得をサポートしていない場合、NDIS_STATUS_NOT_SUPPORTEDを返す必要があります。
GSM ベースのデバイスは、必要に応じてクエリ操作と設定操作をサポートできます。 CDMA ベースのデバイスは、必要に応じて、単純 IP (WWAN_CTRL_CAPS_CDMA_SIMPLE_IP) を報告するクエリ操作をサポートできます。
MB デバイスまたは SIM に格納されているプロビジョニング済みコンテキスト エントリは、デバイスに対してローカルです。 ミニポート ドライバーは、これらのフィールドで読み取るためにネットワークに接続しないでください。
セット要求の入力構造がNDIS_WWAN_SET_PROVISIONED_CONTEXTされ、このオブジェクトの状態表示がNDIS_STATUS_WWAN_PROVISIONED_CONTEXTS。
プロビジョニングされたコンテキストは、APN のリストをキャッシュする 3GPP の GPRS コンテキスト定義と同じではありません。 プロビジョニングされたコンテキストは接続パラメーター (AccessString、UserName、およびパスワード) であり、オペレーターによって事前プロビジョニングされるか、デバイスによってプロビジョニングされた OTA で、デバイス メモリまたは SIM に格納できます。 プロビジョニングされたコンテキストによって返される接続パラメーターは、PDP アクティブ化のために MB サービスによって使用されます。
このオブジェクトのクエリ形式と設定形式の両方が使用されます。
この要求の処理にはネットワーク アクセスは必要ありませんが、MB デバイス上の SIM または補助メモリへのアクセスが必要です。
ミニポート ドライバーは、オペレーティング システムNDIS_STATUS_WWAN_PROVISIONED_CONTEXTS通知を送信します。 ContextListHeader.ElementType メンバーは、WwanStructContext に設定する必要があります。 ミニポート ドライバーは、ContextListHeader.ElementCount メンバーを 0 に設定する必要があります通知が設定された要求に応答して送信されます。
MB サービスは、個々のコンテキストのアクティブ化または非アクティブ化を実行する前に、デバイスからプロビジョニングされたコンテキストの一覧を取得する必要があります。 プロビジョニングされたコンテキストの一覧は、デバイスに複数のネットワーク プロバイダー コンテキストを格納する機能がある場合でも、ホーム プロバイダー ネットワークのみに制限する必要があります。 ローミングの場合でも、コンテキスト リストは常にホーム プロバイダー ネットワーク固有である必要があります。
SET OID_WWAN_PROVISIONED_CONTEXT操作では、コンテキストを、WWAN_SET_CONTEXT構造体のメンバー ProviderId の set 要求で指定されたネットワーク プロバイダー 関連付ける必要があります。 セット OID_WWAN_PROVISIONED_CONTEXT要求によって格納されるプロビジョニング済みコンテキストは、システムの再起動とデバイスの電源リサイクルの間で保持される必要があります。
すべての空のコンテキストは、ホーム プロバイダー ネットワークに適用できるプロビジョニングされたコンテキストと共に、クエリで報告する必要があります。
SimpleIP 用に構成された CDMA デバイス、WwanControlCaps の WWAN_CTRL_CAPS_CDMA_SIMPLE_IP でのレポートは、必要に応じて、適切な AccessString、UserName、および MB Service からのクエリ要求の パスワード メンバーで満たされたプロビジョニング済みコンテキストを少なくとも 1 つ返すことができます。
プロビジョニングされたコンテキストリストは、デバイスで事前にプロビジョニングするか、OID_WWAN_PROVISIONED_CONTEXT操作を設定して更新するか、SMS または OTA を使用してデバイス/オペレーターによって更新する必要があります。 MB サービスによってOID_WWAN_CONNECT操作で提供されるコンテキスト情報に基づいて動的に更新することはできません。
一覧でプロビジョニングされた各コンテキストの MB デバイスから AccessString、UserName、および Password にアクセスする方法の詳細については、「WWAN_CONTEXTを参照してください。
必要条件
バージョン |
Windows 7 以降のバージョンの Windows で使用できます。 |
ヘッダ |
Ntddndis.h (Ndis.h を含む) |
関連項目
WWAN パケット コンテキスト管理 の