MB LTE アタッチ操作
MBIM モデムの LTE アタッチ APN 構成
従来、LTE アタッチは登録の一部と見なされており、Windows は LTE アタッチ手順に直接関与していません。 ただし、一般的な回線切り替えネットワーク登録とは異なり、LTE はパケット切り替え専用ネットワークであり、デバイスが LTE ネットワークで登録を維持するために既定の EPS ベアラーが有効化されていることを必要とします。
ネットワークで既定の EPS ベアラーを確立するために、デバイスは LTE アタッチ手順中に PDP コンテキストのアクティブ化を要求する必要があります。これには、アクセス ポイント名 (APN) の指定が必要です。 3GPP 標準では、デバイスが LTE アタッチを試みるときに APN を指定できるシナリオは 4 つあります。
- デバイスが特定の LTE アタッチ APN を指定する。
- デバイスは特定の LTE アタッチ APN を指定するが、ネットワークはローミング中にデバイスを別の APN にアタッチさせることを決定する。
- デバイスは LTE アタッチ APN を指定せず、ネットワークに 1 つをデバイスに割り当て直させる。
- デバイスが 2G/3G ネットワークから LTE に登録し、少なくとも 1 つのアクティブな PDP コンテキストが既に存在する。 ネットワークが、それを LTE アタッチ APN として使用する。
現在、すべての LTE アタッチ APN 情報は、その構成の対象となる各プロバイダーのモデムで IHV と OEM によって直接提供されています。 ただし、世界中のすべてのオペレーターを対象に可能なすべての LTE アタッチ APN 設定を IHV と OEM が持つことは、モデルとして十分にスケーラブルとは言えません。 Windows 10 バージョン 1703 以降では、NDIS OID と MBIM Microsoft 独自 CID の両方に対して新しいインターフェイスが定義され、OS からの LTE アタッチ APN 構成がサポートされます。
Windows 10 バージョン 1703 以降では、基盤のハードウェアが OS からの LTE アタッチ APN 構成をサポートしている場合、ユーザーは設定から LTE アタッチ APN を構成できます。 既定の LTE アタッチ APN 構成を持つハードウェアでは、その構成を OS で使用できるようにする必要もあります。
この機能は、2 つの新しい OID と CID で追加するとサポートされます。 MBIM を実装する IHV パートナーの場合、CID バージョンのみがサポートを受ける必要があります。
MB アタッチ オペレーション用の MB インターフェイス更新
2 つの新しい MBIM CID が作成され、LTE アタッチ APN 構成と OS が、デバイスの最新 LTE アタッチ状態を取得できるようになりました。 IHV パートナーが OS の既定 LTE アタッチ APN 管理をサポートすることを決定した場合は、両方のコマンドのサポートが必要となります。
サービス名 = 基本的な接続拡張機能
UUID = UUID_BASIC_CONNECT_EXTENSIONS
UUID 値 = 3d01dcc5-fef5-4d05-0d3abef7058e9aaf
| CID | コマンド コード | Minimum OS Version |
|---|---|---|
| MBIM_CID_MS_LTE_ATTACH_CONFIG | 3 | Windows 10 Version 1703 |
| MBIM_CID_MS_LTE_ATTACH_STATUS | 4 | Windows 10 Version 1703 |
MBIM_CID_MS_LTE_ATTACH_CONFIG
説明
LTE アタッチ コンテキストは、ネットワークが実行時にデバイスとやり取りする方法に応じて異なる場合があります。 このドキュメンテーションの残りの部分では、LTE アタッチ コンテキストは、LTE アタッチに使用されている現在の PDP コンテキストとして言及され、既定の LTE アタッチ コンテキストは、他の既存の有効 PDP コンテキストがない場合に LTE アタッチを実行するデバイスで構成されているものとして言及されます。 MBIM_CID_MS_LTE_ATTACH_CONFIG を使用すると、OS は、挿入された SIM のプロバイダー (MCC/MNC ペア) の既定の LTE アタッチ コンテキストに対する Query や Set を行えるようになります。
LTE アタッチ APN は技術的にはコンテキストと見なされますが、モデムに格納されている他のすべてのコンテキストとは異なります。 他のすべてのコンテキストのアクティブ化は登録後に行われ、さまざまな条件に基づいて、OS は接続に最適なコンテキストを決定できます。 ただし、LTE アタッチ コンテキストは、LTE ネットワーク上のデバイス登録の一部として有効になります。 OS は、登録が完了する前にネットワーク関連の状態を取得できません。この制限により、OS は、ローミング状態に関係なく、デバイスが LTE ネットワークに登録できることを確かめるために、デバイスのさまざまなローミング条件すべてに対して LTE アタッチ コンテキストを構成できる必要があります。
ネットワークを使用した LTE アタッチ コンテキストのアクティブ化では、OS がモデムが自ら始めたコンテキスト アクティブ化を認識していないため、OS 明示型接続要求は必要ありません。 既定の LTE アタッチ コンテキストは、このカテゴリに分類されます。 OS が PDP コンテキストを有効にする MBIM_CID_CONNECT 要求を発行し、指定された PDP コンテキストが次のすべてに一致する場合、モデムは、ネットワークで新しい無線ベアラーを起動することなく、CID アクティブ化要求を正常に完了することになります。
- モデムによって開始され、OS で使用できない、既存の有効な PDP コンテキストがある。
- この PDP コンテキストが、CID 要求で指定された APN と一致する。
- 有効な PDP コンテキストの IP タイプが、CID の要求された IP タイプと互換性がある。
OS はモデムによって開始されたすべての PDP コンテキストを認識していないため、これは重要です。 これにより、ネットワークのノイズと負荷が軽減されます。 それ以外の場合、モデムは、通常のコンテキスト アクティブ化要求に従って、OS APN 仕様に一致する新しい無線ベアラーを起動することになります。 ここでは、IP タイプの互換性を指定します。
| モデム内の有効化 PDP コンテキストの IP タイプ | 要求された IP タイプと互換性がある | 要求された IP タイプと互換性がない |
|---|---|---|
| IPv4 | 既定、IPv4、IPv4v6、IPv4 と v6 | IPv6 |
| IPv6 | 既定、IPv6、IPv4v6、IPv4 と v6 | IPv4 |
| IPv4v6 | 既定、IPv4、IPv4v6、IPv4 と v6 | なし |
Note
IP タイプの 1 つだけが無線で有効化されている場合、モデムは 2 番目の PDP コンテキストを起動しません。 たとえば、IPv4 が有効化されていて、ホストが IPv4 と IPv6 を要求した場合、モデムは IPv6 ベアラーを起動せずにアクティブ化要求を完了することになります。
OS が PDP コンテキストを非アクティブ化する MBIM_CID_CONNECT 要求を発行すると、モデムは次をチェックすることになります。
- デバイスが LTE にアタッチされていて、非アクティブ化されるコンテキストが、LTE 登録を維持する唯一の有効な PDP コンテキストであるかどうか
- 非アクティブ化するコンテキストが、OS に公開されていないサービスに対してモデムによって内部的に使用もされるかどうか
これらのいずれかが true の場合、モデムは、CID 非アクティブ化要求を完了するもののネットワークで無線ベアラーを維持し続けることになります。 それ以外の場合、モデムは通常の非アクティブ化要求に従ってコンテキストを非アクティブ化することになります。
OS によって提供されるすべての既定の LTE アタッチ APN 構成はプロバイダーごとであり、挿入された SIM カードのホーム プロバイダー ID (MCC/MNC ペア) と一致します。 モデムはクエリ時に、現在挿入されている SIM のプロバイダー ID に対して、構成済みの LTE アタッチ コンテキストのみを提供することになります。 モデムは常に、挿入された SIM のプロバイダー ID と一致する 3 つの既定の LTE アタッチ コンテキストを、 ローミング条件 (ホーム/パートナー/非パートナー) ごとに 1 つづつ返すことになります。
SIM スワップ全体で、モデムは、次の SIM カードの構成を適用する前に、既定の LTE アタッチ コンテキストを消去することになります。 新しく挿入された SIM カードに既定の LTE アタッチ コンテキスト構成がない場合、デバイスは、コンテキストを有効にしたまま、すべてのローミング条件の LTE アタッチ コンテキストの APN に対して NULL を返すことになります。 コンテキストが無効になっている場合、LTE アタッチに使用できる構成がないため、デバイスが LTE でアタッチしないと想定されます。 ユーザーがデバイスで以前に構成された SIM カードに戻るときに、モデムは SIM カードの工場出荷時の LTE アタッチ構成を復元することになります。 実行時構成が SIM スワップ間で保持されるとは想定されません。 いつでも、ローミング条件 (ホーム/パートナー/非パートナー) ごとに、モデムには既定の LTE アタッチ APN が 1 つだけ存在することになります。
Set コマンド (ローミング条件ごとに 1 つ) が発行されると、OS は常に 3 つの既定の LTE アタッチ コンテキストすべてを設定します。 OS によって提供されるリストに正確に 3 つがない場合、Set コマンドは拒否されることになります。 提供された既定の LTE アタッチ コンテキストのいずれかが、ローミング条件が現在の登録状態と一致する OS によって構成されている場合、モデムはネットワークからデタッチし、新しく指定された LTE アタッチ コンテキストで LTE アタッチを再実行することになります。 それ以外の場合、デバイスは、ローミング条件が次に一致したときに、指定された既定の LTE アタッチ コンテキストを使用することが想定されます。 デバイス指定の既定の LTE アタッチ コンテキストが LTE ネットワークへの登録に失敗した場合、デバイスは必要に応じて 3G/2G にフォールバックすることになります。 モデムは、パートナー ネットワークと非パートナー ネットワークを区別できない場合、すべてのローミング シナリオで、非パートナーの既定の LTE アタッチ コンテキストを使用することになります。 OS が既定の LTE アタッチ コンテキストを IP タイプ = 既定として構成する場合、モデムは LTE アタッチ コンテキストに最も適切な IP タイプを割り当てると想定されます。 ただし、OS は、構成を正確に反映する LTE アタッチ コンテキストのパートナー ローミング条件と IP タイプが引き続きモデムから返されると想定しています。
IHV と OEM は、LTE アタッチ コンテキストをモデムの既定の構成として事前構成できますが、これらのコンテキストには MBIM_MS_CONTEXT_SOURCE = MbimMsContextSourceModemProvisioned としてタグ付けする必要があります。
3GPP 標準で、既定の LTE アタッチ コンテキストは、UE 開始とネットワーク開始の 2 つのカテゴリに分割できます。 デバイスが NULL で構成されている場合、デバイスは LTE アタッチ コンテキストをネットワークに提供せず、ネットワークが 1 つをデバイスに割り当て戻すのを待つことが想定されます。 MBIM 1.0 で規定されているように、LTE アタッチ コンテキストの IP タイプがデフォルトとして構成されている場合、モデムは内部アルゴリズムに基づいて最適な IP タイプを選択することになります。
次の図は、LTE アタッチ構成のフローの例を示しています。
クエリ
MBIM_MS_LTE_ATTACH_CONFIG_INFO は、InformationBuffer での完了した Query メッセージと Set メッセージから返されます。 Query において、InformationBuffer は NULL です。
Set
Set において、InformationBuffer には MBIM_MS_SET_LTE_ATTACH_CONFIG が含まれます。
無承諾イベント
Event InformationBuffer には、MBIM_MS_LTE_ATTACH_CONFIG_INFO 構造体が含まれています。 場合によっては、既定の LTE アタッチ コンテキストは、Over-The-Air (OTA) により、または、OS から MBIM_CID_MS_LTE_ATTACH_CONFIG コマンドを経由しないショート メッセージ サービス (SMS) により更新されます。 この機能は、既定の LTE アタッチ コンテキストとタグ MBIM_MS_CONTEXT_SOURCE = MbimMsContextSourceOperatorProvisioned を適宜更新する必要があります。 その後、機能は、更新リストによりこのイベントを使用する更新についてホストに通知する必要があります。
パラメーター
| 操作 | Set | クエリ | 通知 |
|---|---|---|---|
| コマンド | MBIM_SET_MS_LTE_ATTACH_CONFIG | 適用なし | 適用なし |
| 回答 | MBIM_MS_LTE_ATTACH_CONFIG_INFO | MBIM_MS_LTE_ATTACH_CONFIG_INFO | MBIM_MS_LTE_ATTACH_CONFIG_INFO |
データ構造
クエリ
InformationBuffer は NULL となり、InformationBufferLength は 0 となります。
Set
InformationBuffer では、次の MBIM_MS_SET_LTE_ATTACH_CONFIG 構造体を使用することになります。 Set コマンドは、リストが要素数 3 を含む場合にのみ、ローミング条件 (ホーム/パートナー/非パートナー) ごとに 1 つ有効です。
| オフセット | サイズ | フィールド | タイプ | 説明 |
|---|---|---|---|---|
| 0 | 4 | 操作 | MBIM_MS_LTE_CONTEXT_OPERATIONS | Set コマンドを使用するオペレーションのタイプを指定します。 MbimMsLteAttachContextOperationRestoreFactory に設定されている場合、他のすべてのフィールドは無視されます。 OS で作成または変更された既定の LTE アタッチ コンテキストは削除され、工場出荷時に構成された既定の LTE アタッチ コンテキストが読み込まれます。 モデムに既定の構成がない場合、すべてのローミング条件の既定の LTE アタッチ コンテキストは、空の APN 文字列、および IP タイプ = 既定値、に設定されることになります。 |
| 4 | 4 | ElementCount (EC) | UINT32 | DataBuffer に続く MBIM_MS_LTE_ATTACH_CONTEXT 構造体の数。 このコンポーネントは現在、ローミング条件 (ホーム/パートナー/非パートナー) ごとに 1 つ、3 に指定されています。 |
| 8 | 8 * EC | MsLteAttachContextRefList | OL_PAIR_LIST | ペアの最初の要素は、この MBIM_MS_LTE_ATTACH_CONFIG_INFO 構造体の先頭 (オフセット 0) から計算された、MBIM_MS_LTE_ATTACH_CONTEXT 構造体への 4 バイトのオフセットです (詳細については、MBIM_MS_LTE_ATTACH_CONTEXT テーブルを参照してください)。 ペアの 2 番目の要素は、対応する MBIM_MS_LTE_ATTACH_CONTEXT 構造体へのポインターの 4 バイト サイズです。 |
| 8 + (8 * EC) | DataBuffer | DATABUFFER | MBIM_MS_LTE_ATTACH_CONTEXT 構造体の配列。 |
前のテーブルでは、次の構造体が使用されています。
MBIM_MS_LTE_ATTACH_CONTEXT_OPERATIONS では、Set コマンドで使用できるオペレーションのタイプについて説明します。
| Type | 値 | 説明 |
|---|---|---|
| MbimMsLteAttachContextOperationDefault | 0 | モデムにある既存の既定 LTE アタッチ コンテキストを上書きするための既定オペレーション。 OS は、ローミング条件の 3 つの既定の LTE アタッチ コンテキストをすべて常に置き換えます。 |
| MbimMsLteAttachContextOperationRestoreFactory | 1 | 現在挿入されている SIM のプロバイダー ID における工場出荷時の構成済み既定 LTE アタッチ コンテキストを復元します。 OS によって置き換えられた、または作成されたすべての既定 LTE アタッチ コンテキストは削除して置き換えることになります。 1 つ以上のローミング条件を持つ現在の挿入された SIM プロバイダー ID に事前構成済み既定 LTE アタッチ コンテキストがない場合、既定 LTE アタッチは、空の APN 文字列と IP タイプ = 既定値、を返すことになります。 |
MBIM_MS_LTE_ATTACH_CONTEXT は、LTE アタッチ構成に使用するコンテキストを指定します。
| オフセット | サイズ | フィールド | タイプ | 説明 |
|---|---|---|---|---|
| 0 | 4 | IPType | MBIM_CONTEXT_IP_TYPE | 詳細については、MBIM_CONTEXT_IP_TYPE テーブルを参照してください。 |
| 4 | 4 | ローミング | MBIM_MS_LTE_ATTACH_CONTEXT_ROAMING_CONTROL | この既定 LTE アタッチ コンテキストに適用されるローミング条件を示します。 詳細については、MBIM_MS_LTE_ATTACH_CONTEXT_ROAMING_CONTROL テーブルを参照してください。 |
| 8 | 4 | ソース | MBIM_MS_CONTEXT_SOURCE | コンテキストの作成ソースを指定します。 詳細については、MBIM_MS_CONTEXT_SOURCE テーブルを参照してください。 |
| 12 | 4 | AccessStringOffset | OFFSET | ネットワークにアクセスするための文字列 "AccessString" に対するデータ バッファー内のオフセット。 GSM ベースのネットワークの場合、これは "data.thephone-company.com" などのアクセス ポイント名 (APN) 文字列になります。 文字列のサイズは 100 文字を超えないようにしてください。 AccessString が空の場合、デバイスはネットワークがアクセス文字列をデバイスに割り当てることを想定します。 この場合、依然として IP タイプを指定する必要があります。 |
| 16 | 4 | AccessStringSize | SIZE(0..200) | AccessString に使用されるサイズ。 ネットワークが LTE アタッチ用にアクセス文字列をデバイスに割り当て戻すとデバイスが想定する場合、この値は 0 となります。 |
| 20 | 4 | UserNameOffset | OFFSET | この構造体の先頭から計算された、認証するユーザー名を表す文字列 "UserName" へのオフセット (バイト単位)。 このメンバーは NULL とできます。 |
| 24 | 4 | UserNameSize | SIZE(0..510) | UserName に使用されるサイズ。 |
| 28 | 4 | PasswordOffset | OFFSET | この構造体の先頭から計算された、ユーザー名のパスワードを表す文字列 "Password" へのオフセット (バイト単位)。 このメンバーは NULL とできます。 |
| 32 | 4 | PasswordSize | SIZE(0..510) | Password に使用されるサイズ。 |
| 36 | 4 | 圧縮 | MBIM_COMPRESSION | ヘッダーとデータのデータ接続で使用する圧縮を指定します。 このメンバーは GSM ベースのデバイスにのみ適用されます。 CDMA ベースのデバイスの場合、ホストはこのメンバーを MBIMCompressionNone に設定します。 詳細については、MBIM_COMPRESSION テーブルを参照してください。 |
| 40 | 4 | AuthProtocol | MBIM_AUTH_PROTOCOL | PDP アクティブ化に使用する認証タイプ。 詳細については、MBIM_AUTH_PROTOCOL テーブルを参照してください。 |
| 44 | DataBuffer | DATABUFFER | AccessString、UserName、および Password を含むデータ バッファー。 |
MBIM_MS_LTE_ATTACH_CONTEXT_ROAMING_CONTROL は、この既定 LTE アタッチ コンテキストに適用されるローミング条件を示します。
| Type | 値 | 説明 |
|---|---|---|
| MbimMsLteAttachContextRoamingControlHome | 0 | 既定 LTE アタッチ コンテキストをホーム ネットワークで使用できるかどうかを示します。 |
| MbimMsLteAttachContextRoamingControlPartner | 1 | コンテキストの使用をパートナー ローミング ネットワークで許可するかどうかを示します。 |
| MbimMsLteAttachContextRoamingControlNonPartner | 2 | コンテキストの使用を非パートナー ローミング ネットワークで許可するかどうかを示します。 |
MBIM_MS_CONTEXT_SOURCE がコンテキストの作成ソースを指定します。
| Type | 値 | 説明 |
|---|---|---|
| MbimMsContextSourceAdmin | 0 | コンテキストは、OS からエンタープライズ IT 管理者によって作成されました。 |
| MbimMsContextSourceUser | 1 | コンテキストは、OS 設定を通してユーザーによって作成されました。 |
| MbimMsContextSourceOperator | 2 | コンテキストは、OMA-DM または他のチャンネルを通してオペレーターによって作成されました。 |
| MbimMsContextSourceModem | 3 | コンテキストは、IHV または OEM によって作成されました。 |
| MbimMsContextSourceDevice | 4 | コンテキストは OS APN データベースによって作成されました。 |
回答
InformationBuffer では、次の MBIM_MS_LTE_ATTACH_CONFIG_INFO 構造体を使用することになります。
| オフセット | サイズ | フィールド | タイプ | 説明 |
|---|---|---|---|---|
| 0 | 4 | ElementCount (EC) | UINT32 | DataBuffer に続く MBIM_MS_LTE_ATTACH_CONTEXT 構造体の数。 このコンポーネントは現在、ローミング条件 (ホーム/パートナー/非パートナー) ごとに 1 つ、3 に指定されています。 |
| 4 | 8 * EC | MsLteAttachContextRefList | OL_PAIR_LIST | ペアの最初の要素は、この MBIM_MS_LTE_ATTACH_CONFIG_INFO 構造体の先頭 (オフセット 0) から計算された、MBIM_MS_LTE_ATTACH_CONTEXT 構造体への 4 バイトのオフセットです (詳細については、MBIM_MS_LTE_ATTACH_CONTEXT テーブルを参照してください)。 ペアの 2 番目の要素は、対応する MBIM_MS_LTE_ATTACH_CONTEXT 構造体へのポインターの 4 バイト サイズです。 |
| 4 + (8 * EC) | DataBuffer | DATABUFFER | MBIM_MS_LTE_ATTACH_CONTEXT 構造体の配列。 |
通知
詳細については、MBIM_MS_LTE_ATTACH_CONFIG_INFO のテーブルを参照してください。
状態コード
Query および Set オペレーションの場合:
| 状態コード | 説明 |
|---|---|
| MBIM_STATUS_READ_FAILURE | プロビジョニングされたコンテキストをデバイスが取得できなかったため、オペレーションは失敗しました。 |
| MBIM_STATUS_NO_DEVICE_SUPPORT | デバイスがオペレーションをサポートしていないため、オペレーションは失敗しました。 |
Set オペレーションのみ:
| 状態コード | 説明 |
|---|---|
| MBIM_STATUS_INVALID_PARAMETERS | パラメーターが無効なため、オペレーションは失敗しました。 |
| MBIM_STATUS_WRITE_FAILURE | 更新要求が失敗したため、オペレーションは失敗しました。 |
MBIM_CID_MS_LTE_ATTACH_STATUS
説明
3GPP の要件に従って、デバイスは、有効な PDP コンテキストなしでネットワークに LTE アタッチを行うときに使用される既定 LTE アタッチ コンテキストを指定できますが、デバイスで構成された既定 LTE アタッチコンテキストとは異なる PDP コンテキストでデバイスが LTE アタッチを行う場合があります。 考えられるすべてのシナリオの一覧を次に示します。
- UE は、特定の LTE アタッチ APN を指定します。
- 特定の LTE アタッチ APN は UE が指定するが、ローミング中にデバイスを別の APN にアタッチさせることはネットワークが決定します。
- UE は LTE アタッチ APN を指定せず、ネットワークが 1 つをデバイスに割り当て直すようにします。
- UE が 2G/3G ネットワークから LTE に登録し、少なくとも 1 つのアクティブな PDP コンテキストが既に存在します。 ネットワークが、それを LTE アタッチ APN として使用する。
デバイスは、既定 LTE アタッチ時に、MBIM_CID_MS_LTE_ATTACH_STATUS の通知を OS に送信して、最新の LTE アタッチメントの PDP コンテキストの詳細を提供することになります。 既定 LTE アタッチは、次のいずれかのシナリオが満たされたときに発生します。
- デバイスは最初に LTE ネットワークにアタッチします。
- デバイスは、事前に有効にされた PDP コンテキストなしで 2G/3G から LTE に接続します。
MBIM_CID_LTE_ATTACH_STATUS から返される LTE アタッチ コンテキストは、次のいずれかになります。
- モデムに格納されている既定 LTE アタッチ コンテキスト。
- ネットワークから割り当てられた既定 LTE アタッチ コンテキスト。
実行時に、OS は、既定 LTE アタッチに対して最後に使用されたアタッチ情報をクエリすることもできます。 モデムは、最後に既知となった既定 LTE アタッチ コンテキストを返すと想定されます。 デバイスが LTE から 2G/3G ネットワークに切り替えられた場合、モデムには以前の LTE アタッチに使用されたコンテキストを返すと想定されます。 デバイスがネットワークから登録解除するたびに、APN は空になると想定されます。
次の図は、LTE アタッチ状態のメッセージ フローの例を示しています。
クエリ
MBIM_MS_LTE_ATTACH_STATUS は、InformationBuffer の Query 完了メッセージから返されます。 Query において、InformationBuffer は NULL です。
Set
Set オペレーションはサポートされません。
無承諾イベント
Event InformationBuffer には、 MBIM_MS_LTE_ATTACH_STATUS 構造体が含まれています。
パラメーター
| 操作 | Set | クエリ | 通知 |
|---|---|---|---|
| コマンド | 適用なし | 適用なし | 適用なし |
| 回答 | 適用なし | MBIM_MS_LTE_ATTACH_STATUS | MBIM_MS_LTE_ATTACH_STATUS |
データ構造
クエリ
InformationBuffer は NULL となり、InformationBufferLength は 0 となります。
Set
Set オペレーションはサポートされません。
回答
InformationBuffer では、次の MBIM_MS_LTE_ATTACH_STATUS 構造体を使用することになります。
| オフセット | サイズ | フィールド | タイプ | 説明 |
|---|---|---|---|---|
| 0 | 4 | LteAttachState | MBIM_MS_LTE_ATTACH_STATE | デバイスが現在 LTE ネットワークにアタッチされているかどうかを示します。 詳細については、MBIM_MS_LTE_ATTACH_STATE テーブルを参照してください。 |
| 4 | 4 | IPType | MBIM_CONTEXT_IP_TYPES | 詳細については、MBIM_CONTEXT_IP_TYPE テーブルを参照してください。 |
| 8 | 4 | AccessStringOffset | OFFSET | ネットワークにアクセスするための文字列 "AccessString" に対するデータ バッファー内のオフセット。 GSM ベースのネットワークの場合、これは "data.thephone-company.com" などのアクセス ポイント名 (APN) 文字列になります。 CDMA ベースのネットワークの場合は、"#777" などの特殊なダイヤル コードや、"foo@thephone-company.com" などのネットワーク アクセス識別子 (NAI) がこれに該当する可能性があります。 このメンバーは、ネットワークで既定の APN を割り当てることの要求において NULL とできます。 注: すべてのネットワークがこの NULL APN 規則をサポートしているわけではありません。 そのため、無効な APN に起因する接続エラーが発生する可能性があります。 文字列のサイズは 100 文字を超えないようにしてください。 |
| 12 | 4 | AccessStringSize | SIZE(0..200) | AccessString に使用されるサイズ (バイト単位)。 |
| 16 | 4 | UserNameOffset | OFFSET | この構造体の先頭から計算された、認証するユーザー名を表す文字列 "UserName" へのオフセット (バイト単位)。 このメンバーは NULL とできます。 |
| 20 | 4 | UserNameSize | SIZE(0..510) | UserName に使用されるサイズ (バイト単位)。 |
| 24 | 4 | PasswordOffset | OFFSET | この構造体の先頭から計算された、ユーザー名のパスワードを表す文字列 "Password" へのオフセット (バイト単位)。 このメンバーは NULL とできます。 |
| 28 | 4 | PasswordSize | SIZE(0..510) | Password に使用されるサイズ (バイト単位)。 |
| 32 | 4 | 圧縮 | MBIM_COMPRESSION | ヘッダーとデータのデータ接続で使用する圧縮を指定します。 このメンバーは GSM ベースのデバイスにのみ適用されます。 CDMA ベースのデバイスの場合、ホストはこのメンバーを MBIMCompressionNone に設定します。 詳細については、MBIM_COMPRESSION テーブルを参照してください。 |
| 36 | 4 | AuthProtocol | MBIM_AUTH_PROTOCOL | PDP アクティブ化に使用する認証タイプ。 詳細については、MBIM_AUTH_PROTOCOL テーブルを参照してください。 |
| 40 | 4 | DataBuffer | DATABUFFER |
前のテーブルでは、次のデータ構造が使用されています。
MBIM_MS_LTE_ATTACH_STATE は、デバイスが現在 LTE ネットワークにアタッチされているかどうかを示します。
| Type | 値 | 説明 |
|---|---|---|
| MbimMsLteAttachStateDetached | 0 | デバイスが LTE ネットワークにアタッチされていないことを示します。 |
| MbimMsLteAttachStateAttached | 1 | デバイスが LTE ネットワークにアタッチされていることを示します。 |
通知
詳細については、MBIM_MS_LTE_ATTACH_STATUS テーブルを参照してください。
状態コード
Query および Set オペレーションの場合:
| 状態コード | 説明 |
|---|---|
| MBIM_STATUS_READ_FAILURE | プロビジョニングされたコンテキストをデバイスが取得できなかったため、オペレーションは失敗しました。 |
| MBIM_STATUS_NO_DEVICE_SUPPORT | デバイスがオペレーションをサポートしていないため、オペレーションは失敗しました。 |
Hardware Lab Kit (HLK) テスト
「HLK のインストール手順」を参照してください。
HLK で、Studio はデバイスの携帯電話 モデム ドライバーに接続し、テスト (Win6_4.MB.GSM.Data.TestLteAttach) を実行します。
または、TestLteAttach HLK テストリストを netsh-mbn と netsh-mbn-test-installation により実行します。
netsh mbn test feature=lte testpath="C:\\data\\test\\bin" taefpath="C:\\data\\test\\bin"
HLK テスト結果を示すこのファイルは、'netsh mbn test' コマンドの実行元となったディレクトリ (TestLteAttach.htm) に生成されているはずです。
手動テスト
- 要件: 適切な APN 設定と、手動で使用するためのもう 1 つの APN 情報を含む sim。
- [設定] -> [ネットワークとインターネット] -> [携帯電話] を開きます
- [詳細オプション] をクリックします。
携帯ネットワーク設定の使用:
- 少なくとも、sim 情報からの設定である apn が存在することになります。 APN の詳細情報を取得するには、APN をクリックし、[表示] ボタンをクリックします。
手動設定の使用:
- 「携帯電話設定」 の「APN を追加」セクションに従って、APN を手動で設定します。
- APN をアタッチし、アタッチされた状態をチェックします。
MB LTE アタッチのトラブルシューティング ガイド
- %ProgramData%\Microsoft\WwanSvc\DMProfiles のすべての Attach APN プロファイルを取得します
- 作成タイプの優先順位に基づいて適用される特定のプロファイルを把握します
- LTE アタッチ APN が誤って構成された理由をチェックするログを調査します
- 「ログの収集」の指示によりログの収集とデコードを行います
- TextAnalysisTool で生成された .txt ファイルを開きます
- LTE アタッチ フィルターを読み込みます
LTE アタッチのサンプル ログ
10409 [0]0370.0434::2020-03-06 01:16:13.118424000 [WwanDimCommon] ReadyState : WwanReadyStateInitialized (0x1)
14137 [0]0370.0684::2020-03-06 01:16:13.146883200 [WwanProfileManager]INFO: SaveModemConfiguredLteAttachConfig: added modem configured LTE attach profile
14362 [0]0370.0684::2020-03-06 01:16:13.149255900 [WwanProfileManager]INFO: SaveModemConfiguredLteAttachConfig: added modem configured LTE attach profile
14476 [1]0370.0434::2020-03-06 01:16:13.149677900 [WwanDimCommon] ReadyState : WwanReadyStateInitialized (0x1)
14503 [0]0370.0684::2020-03-06 01:16:13.151412000 [WwanProfileManager]INFO: SaveModemConfiguredLteAttachConfig: added modem configured LTE attach profile
14962 [0]0370.0684::2020-03-06 01:16:13.156860700 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanDataExecutor::OnLteAttachProfileUpdate: WwanPmGetLteAttachProfileInEffect() didn't find anything, using Network Assigned.
14963 [0]0370.0684::2020-03-06 01:16:13.156862600 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanDataExecutor::OnLteAttachProfileUpdate: LTEAttachConfig has same config as modem has, skip