MB 布建的內容作業
布建對於可行動電話連線的裝置至關重要，因為每個電信業者在其網路都有不同的APN設定。 APN 組態通常可以分成兩個類別：
- OS 已知的 APN 設定，因為 OS 上方有需要這些連線的應用程式或用戶端。
- OS 未得知的 APN 設定，因為數據機內部會針對 OS 及其用戶端未利用的連線，於內部取用它們。
在理想情況下，數據機應該只儲存OS不需要知道的APN設定。 不過，IHV 和 OEM 合作夥伴傳統上也會在數據機中提供因特網和購買 APN、OS 已知的設定。 在 Windows 10 版本 1703 發行之前，Windows 只會從數據機讀取因特網和購買 APN 設定，以建立因特網連線。 從 Windows 10 版本 1703 開始，可能會有其他情況下，數據機的 APN 設定必須由 Windows 管理，特別是如果操作系統中有用戶端，例如使用者設定或想要變更行動數據設定的 OMA-DM。 這反過來也會影響數據機的APN設定。 例如，數據機中可能會有IMS堆疊使用IMS APN透過IMS進行SMS。 一般而言，這些連線不會公開至OS，但在某些情況下，IMS APN 組態可能必須變更。 這項變更可以透過OS來完成。 為了支援此功能，從 Windows 10 版本 1703 開始，OS 可以將不同類型的 APN 設定為數據機。
USB 論壇的 MBIM 1.0 和 Microsoft NDIS 各有現有的 CID 和 OID，可讓 OS 在數據機中設定及查詢 APN 組態。 針對 MBIM 1.0，它會透過 MBIM_CID_PROVISIONED_CONTEXT 執行這項作業，而針對 NDIS，則會透過 OID_WWAN_PROVISIONED_CONTEXTS執行這項作業。 不過，現有的 CID 和 OID 並未設計清楚指引數據機在電源週期或 SIM 交換等各種情況下的行為。 未來想要支援操作系統設定和更新數據機布建內容的裝置，都必須在 Windows 10 版本 1703 中實作較新版本的 CID 和 OID。 為了確保回溯相容性，對於想要在 1703 版的 OS 版本上支援新硬體的 IHD/OEM，他們必須繼續支援現有的MBIM_CID_PROVISIONED_CONTEXT和OID_WWAN_PROVISIONED_CONTEXTS。 從 Windows 10 版本 1703 開始，如果裝置支援新版本的 CID 和 OID，則 OS 只會使用較新版本的命令來查詢和設定數據機中的 APN 內容組態。
布建內容作業的 MB 介面更新
雖然 MBIM 具有用來擷取和取代儲存在數據機中內容的命令，但是沒有字段可「停用」或「啟用」配置檔。 因此，必須更新 Windows 10 版本 1703 的現有MBIM_CID_PROVISIONED_CONTEXT，才能包含這項功能。 因為 MBIM 沒有版本控制機制，因此新的 MSFT 專屬 CID 會定義為MBIM_CID_MS_PROVISIONED_CONTEXT_V2。
服務名稱 = 基本 連線 擴充功能
UUID = UUID_BASIC_CONNECT_EXTENSIONS
UUID 值 = 3d01dcc5-fef5-4d05-0d3abef7058e9aaf
| CID | 命令碼 | OS 最低版本 |
|---|---|---|
| MBIM_CID_MS_PROVISIONED_CONTEXT_V2 | 1 | Windows 10 版本 1703 |
MBIM_CID_MS_PROVISIONED_CONTEXT_V2
描述
雖然 MBIM 1.0 已為 OS 及其上層用戶端定義MBIM_CID_PROVISIONED_CONTEXT來管理數據機中布建的內容，但 Windows 傳統上只會查詢數據機中的內容，但並未從 OS 設定它。 從 Windows 10 版本 1703 開始，需要增加 OS 才能在數據機中設定內容的需求。 例如，如果數據機中有不透明 OS 的 IMS 堆疊，OS 應該能夠指定數據機應使用的 IMS APN。 由於每個數據機 IHV 都可以有自己的專屬方式將內容儲存在數據機中，因此 OS 不可能以MBIM_CID_PROVISIONED_CONTEXT建議的方式管理 ContextId 層級上的設定檔。 相反地，從OS的觀點來看，指定每個內容類型要使用的內容更為重要。 傳回 IMS 範例，不論數據機中有多少現有的布建內容，如果 OS 設定的內容具有 MBIM_CONTEXT_TYPE = IMS，則數據機起始的所有 IMS 流量應該只會在該內容上嘗試。
MBIM 1.0 指定MBIM_CID_PROVISIONED_CONTEXT只能在符合插入 SIM 卡提供者識別碼 （MCC/MNC 組） 的內容上呼叫查詢。 針對 [設定要求]，MBIM_CID_PROVISIONED_CONTEXT可以指定它想要儲存之內容的提供者標識符。 MBIM_CID_MS_PROVISIONED_CONTEXT_V2會指定與 MBIM 1.0 類似的但不同的行為。 針對每個查詢，OS 會繼續預期數據機只會傳回符合插入 SIM 卡之提供者識別碼的內容。 針對 Set，命令將不再啟用 OS 來設定與 SIM 卡中目前提供者識別碼不符的內容。 預期 Set 要求是建立目前所呈現 SIM 卡提供者標識碼的內容。 例如，使用者會從 SIM 1 交換至 SIM 2，然後切換回 SIM 卡 1。 預期在第一次 SIM 交換期間，數據機應該先解析其所有內容，再載入 SIM 2 的內容。 當使用者交換回 SIM 1 時，應該還原 SIM 1 的原廠預設設定。 預計數據機不會跨 SIM 交換儲存運行時間組態。
下圖說明當使用者從一個 SIM 卡交換到另一個 SIM 卡，然後回到第一個 SIM 卡時，的範例流程。
如果 OS 或使用者想要將數據機中的內容設定還原至原始設定，則預先設定數據機的 OEM 和 IHD 應保留原始處理站設定。 應該只還原目前插入之 SIM 卡提供者識別碼的原始處理站內容。 OS 的組態不應覆寫原始處理站設定預先設定的內容。 下圖是用戶選擇還原原廠設定時的範例流程：
當 SIM 遺失、鎖定或提供者標識碼無法存取時，數據機應該會失敗查詢或設定要求。 數據機每個提供者識別碼每個CONTEXT_TYPE應該只有一個內容。 如果 IHV 或 OEM 決定在數據機中預先設定數據機內容，請務必確定內容已針對選擇這麼做的每個提供者正確設定內容。 如果插入的 SIM 卡沒有 IHV 預先設定的內容，數據機就不應該有任何沒有 OS 設定的內容。 IHV 和 OEM 必須確定MBIM_MS_CONTEXT_SOURCE = MbimMsContextSourceModemProvisioned，如此一來，如果操作系統存在，OS 就會使用數據機的內容進行連線，而不會從 Windows 的 APN 資料庫覆寫它。
數據機對應處理內容的方式，並透過現有的MBIM_CID_PROVISIONED_CONTEXT呈現回內容的方式，最多可達每個 IHV，且未涵蓋本文件的範圍。
新的MBIM_CID_MS_PROVISONED_CONTEXT_V2命令幾乎與 MBIM 1.0 的現有MBIM_CID_PROVISIONED_CONTEXT命令完全相同，但有數個新增專案。 第一個提供OS啟用或停用與數據機中內容類型相關聯的內容的能力。 當數據機中停用內容時，數據機預期不會針對與網路的任何連線使用預存內容，即使是未察覺到 OS 的內容也一樣。 如果 OS 要求與數據機中已停用內容相符的連線，數據機應該立即失敗要求，而不會向網路發出訊號。 比對程序應該符合 MBIM_MS_CONTEXT_V2 結構中的所有欄位。
來自 MBIM 1.0 的MBIM_CONTEXT_IP_TYPE結構僅用於MBIM_CID_CONNECT。 在MBIM_CID_MS_PROVISIONED_CONTEXT_V2中，Microsoft 已將IP類型新增為每個內容的其中一個參數。 如果未針對指定內容設定數據機，則數據機應該回報 MBIMContextIPTypeDefault。
在 Windows 10 版本 1703 中，具有支援MBIM_CID_MS_PROVISIONED_CONTEXT_V2的新硬體，不會使用第一方元件中的舊版MBIM_CID_PROVISIONED_CONTEXT。 如果有其他舊版用戶端/OS元件會向下傳送MBIM_CID_PROVISIONED_CONTEXT，則數據機預期會傳回結果，就像在 Windows 10 版本 1703 之前的 Windows 版本中所做的一樣。
查詢
MBIM_MS_PROVISIONED_CONTEXTS_INFO會從 InformationBuffer 中的查詢和設定完整訊息傳回。
針對 [查詢]，InformationBuffer 為 null。
設定
針對 Set，InformationBuffer 包含MBIM_MS_SET_PROVISIONED_CONTEXT_V2結構。 在設定作業中，因為每個數據機 IHV 都可以有專屬的管理內容儲存方式，因此 OS 不再指定 ContextId 字段，並預期數據機會將內容對應至適當的位置。 當OS設定內容時，它預期數據機會用於符合指定內容MBIM_CONTEXT_TYPE的所有連線。 如果數據機無法辨識MBIM_CONTEXT_TYPE，它仍應該儲存它，即使它可能未與其連線。
未請求的事件
事件資訊Buffer 包含MBIM_MS_PROVISIONED_CONTEXTS_INFO_V2結構。 在某些情況下，布建的內容清單會由網路更新：Over-The-The-Air （OTA） 或短訊息服務 （SMS），而不會從操作系統超過 MBIM_CID_MS_PROVISIONED_CONTEXT_V2 命令。 函式必須據以更新布建的內容清單和標記MBIM_MS_CONTEXT_SOURCE = MbimMsContextSourceOperatorProvisioned。 之後，函式必須透過更新清單通知主機有關使用此事件進行更新的相關信息。
參數
| 作業 | 設定 | 查詢 | 通知 |
|---|---|---|---|
| Command | MBIM_SET_MS_PROVISIONED_CONTEXT_V2 | 不適用 | 不適用 |
| 回應 | MBIM_MS_PROVISIONED_CONTEXT_INFO_V2 | MBIM_MS_PROVISIONED_CONTEXT_INFO_V2 | MBIM_MS_PROVISIONED_CONTEXT_INFO_V2 |
資料結構
查詢
InformationBuffer 應為 NULL，InformationBufferLength 應為零。
設定
下列MBIM_SET_MS_PROVISIONED_CONTEXT_V2數據結構應該用於 InformationBuffer。
| 位移 | 大小 | 欄位 | 類型 | 描述 |
|---|---|---|---|---|
| 0 | 4 | 作業 | MBIM_MS_CONTEXT_OPERATIONS | 指定使用 SET 命令的作業類型。 如果設定為 MbimMsContextOperationDelete，則應該刪除指定之MBIM_CONTEXT_TYPES的內容，並忽略MBIM_SET_MS_PROVISIONED_CONTEXT_V2中的所有其他欄位。 如果設定為 MbimMsContextOperationRestoreFactory，則應該移除所有 OS 建立或修改的內容，應該載入預設處理站預先設定的內容，並忽略MBIM_SET_MS_PROVISIONED_CONTEXT_V2中的所有其他字段。 |
| 4 | 16 | ContextType | MBIM_CONTEXT_TYPES | 指定要表示的內容類型;例如，因特網連線、VPN（公司網路連線），或語音轉播IP（VOIP）。 如需詳細資訊，請參閱MBIM_CONTEXT_TYPES數據表。 |
| 20 | 4 | IPType | MBIM_CONTEXT_IP_TYPES | 指定要表示的內容類型;例如，因特網連線、VPN（公司網路連線），或語音轉播IP（VOIP）。 如需詳細資訊，請參閱MBIM_CONTEXT_IP_TYPES數據表。 |
| 24 | 4 | 啟用 | MBIM_MS_CONTEXT_ENABLE | 指定數據機是否可以使用內容。 如果它設定為 MbimMsContextDisabled，則任何符合內容的 OS 連線要求都應該失敗，而不會向網路發出訊號。 如需詳細資訊，請參閱MBIM_MS_CONTEXT_ENABLE數據表。 |
| 28 | 4 | 漫遊 | MBIM_MS_CONTEXT_ROAMING_CONTROL | 指定是否允許此內容漫遊。 如需詳細資訊，請參閱MBIM_MS_CONTEXT_ROAMING_CONTROL數據表。 |
| 32 | 4 | MediaType | MBIM_MS_CONTEXT_MEDIA_TYPE | 指定內容所使用的媒體傳輸類型。 如需詳細資訊，請參閱MBIM_MS_CONTEXT_MEDIA_TYPE數據表。 |
| 36 | 4 | 來源 | MBIM_MS_CONTEXT_SOURCE | 指定內容的建立來源。 如需詳細資訊，請參閱MBIM_MS_CONTEXT_SOURCE數據表。 |
| 40 | 4 | AccessStringOffset | OFFSET | 數據緩衝區中的位移至字串 AccessString，以存取網路。 針對 GSM 型網路，這會是存取點名稱 （APN） 字串，例如 「data.thephone-company.com」。。 針對 CDMA 型網路，這可能是特殊的撥號代碼，例如 “#777” 或網络存取標識碼 （NAI），例如 “foo@thephone-company.com”。 此成員可以是 NULL，要求網路指派預設 APN。 注意：並非所有網路都支援此 NULL APN 慣例，因此無效 APN 所造成的連線失敗是可能的結果。 字串的大小不應超過100個字元。 |
| 44 | 4 | AccessStringSize | SIZE（0..200） | 用於 AccessString 的大小。 |
| 48 | 4 | UserNameOffset | OFFSET | 以位元組為單位的位移，從這個結構的開頭計算到字元串UserName，代表要驗證的用戶名稱。 這個成員可以是 NULL。 |
| 52 | 4 | UserNameSize | SIZE（0..510） | 用於 UserName 的大小。 |
| 56 | 4 | PasswordOffset | OFFSET | 以位元組為單位的位移，從這個結構的開頭算起，到代表使用者名稱密碼的字串 Password。 這個成員可以是 NULL。 |
| 60 | 4 | PasswordSize | SIZE（0..510） | 用於密碼的大小。 |
| 64 | 4 | 壓縮 | MBIM_COMPRESSION | 指定要用於標頭和數據之數據連接中的壓縮。 此成員僅適用於 GSM 型裝置。 主機會將此成員設定為以CDMA為基礎的裝置的MBIMCompressionNone。 如需詳細資訊，請參閱MBIM_COMPRESSION數據表。 |
| 68 | 4 | AuthProtocol | MBIM_AUTH_PROTOCOL | 用於 PDP 啟用的驗證類型。 如需詳細資訊，請參閱MBIM_AUTH_PROTOCOL數據表。 |
| 72 | 4 | DataBuffer | DATABUFFER | 包含 AccessString、UserName 和 Password 的數據緩衝區。 |
上表中會使用下列數據結構。
MBIM_MS_CONTEXT_ROAMING_CONTROL指定個別內容漫遊原則。 OS 可以指定是否可以在漫遊期間啟用指定的內容。 如果漫遊狀態不符合指定條件，則數據機不應在沒有OS介入的情況下自行啟動內容。 如果數據機不支援合作夥伴，則所有合作夥伴設定都應該視為相當於首頁。
| 類型 | 值 | Description |
|---|---|---|
| MbimMsContextRoamingControlHomeOnly | 0 | 指出內容是否只允許在家庭網路中使用。 |
| MbimMsContextRoamingControlPartnerOnly | 1 | 指出內容是否只允許用於合作夥伴漫遊網路。 |
| MbimMsContextRoamingControlNonPartnerOnly | 2 | 指出內容是否只允許用於非合作夥伴漫遊網路。 |
| MbimMsContextRoamingControlHomeAndPartner | 3 | 指出內容是否允許在家庭和合作夥伴漫遊網路中使用。 |
| MbimMsContextRoamingControlHomeAndNonPartner | 4 | 指出內容是否允許在家庭和非合作夥伴漫遊網路中使用。 |
| MbimMsContextRoamingControlPartnerAndNonPartner | 5 | 指出是否允許內容用於合作夥伴和非夥伴漫遊網路。 |
| MbimMsContextRoamingControlAllowAll | 6 | 指出內容是否允許在任何漫遊狀況中使用。 |
已新增 MBIM_MS_CONTEXT_MEDIA_TYPE，以指定當未來平台支援Wi-Fi卸除時，內容是否用於行動數據或iWLAN。 例如，如果內容設定為行動數據，且數據機目前為Wi-Fi卸除，則不應該使用該內容起始連線。
| 類型 | 值 | Description |
|---|---|---|
| MbimMsContextMediaTypeCellularOnly | 0 | 指出內容是否只允許在透過行動數據註冊時使用。 |
| MbimMsContextMediaTypeWifiOnly | 1 | 指出在 iWLAN 上註冊時，是否只允許使用內容（Wi-Fi 卸除）。 |
| MbimMsContextMediaTypeAll | 2 | 指出透過行動數據或Wi-Fi註冊時，是否允許使用內容。 |
MBIM_MS_CONTEXT_ENABLE指定是否啟用或停用內容。
| 類型 | 值 | Description |
|---|---|---|
| MbimMsContextDisabled | 0 | 已停用布建的內容。 數據機不應該從OS和本身啟用此內容。 |
| MbimMsContextEnabled | 1 | 布建的內容已啟用。 如果符合其他條件，則可以啟用內容;例如，如果不允許漫遊，則不應該在漫遊期間啟用內容。 |
已新增MBIM_MS_CONTEXT_SOURCE，讓OS能夠了解數據機內容的建立方式。 這可協助 OS 在各種情況之後正確運作，例如原廠重設，因此可以知道應該保存什麼，以及應該根據各種操作員需求傳回默認狀態的內容。
| 類型 | 值 | Description |
|---|---|---|
| MbimMsContextSource 管理員 | 0 | 內容是由來自OS的企業IT系統管理員所建立。 |
| MbimMsContextSourceUser | 1 | 內容是由使用者透過OS設定所建立。 |
| MbimMsContextSourceOperator | 2 | 內容是由運算子透過 OMA-DM 或其他通道所建立。 |
| MbimMsContextSourceModem | 3 | 內容是由隨附於數據機韌體中的IHV或 OEM 所建立。 |
| MbimMsContextSourceDevice | 4 | 內容是由OS APN資料庫所建立。 |
MBIM_MS_CONTEXT_OPERATIONS指定 OS 可以執行的作業，以在數據機中設定內容。
| 類型 | 值 | Description |
|---|---|---|
| MbimMsContextOperationDefault | 0 | 默認作業，包括新增或取代數據機中的現有內容。 |
| MbimMsContextOperationDelete | 1 | 刪除作業需要數據機刪除數據機刪除數據機中的現有內容。 |
| MbimMsContextOperationRestoreFactory | 2 | 還原目前插入 SIM 卡之提供者標識碼的原廠預先設定內容。 應該移除或取代OS所建立的所有內容。 如果目前插入的 SIM 提供者識別碼沒有預設預先設定的 OS 內容，則應移除數據機中布建的內容。 |
來自 MBIM 1.0 的原始MBIM_CONTEXT_TYPES仍然有效。 Microsoft 正在新增其他內容類型，因為已定義 MBIM 1.0 之後，引進更多類型的內容。 下表定義所引進的新類型。 IHV 和 OEM 可能會定義其他專屬內容類型，以及 OS 無法自行辨識的其他唯一 UUID 值。
| 類型 | 值 | Description |
|---|---|---|
| MBIMMsContextType 管理員 | 5f7e4c2e-e80b-40a9-a239-f0abcfd11f4b | 內容用於管理用途，例如裝置管理。 |
| MBIMMSContextTypeApp | 74d88a3d-dfbd-4799-9a8c-7310a37bb2ee | 內容會用於行動電信業者所允許的特定應用程式。 |
| MBIMMsContextTypeXcap | 50d378a7-baa5-4a50-b872-3fe5bb463411 | 內容用於 IMS 服務上的 XCAP 佈建。 |
| MBIMMsContextTypeTethering | 5e4e0601-48dc-4e2b-acb8-08b4016bbaac | 內容用於行動熱點系結。 |
| MBIMMsContextTypeEmergencyCalling | 5f41adb8-204e-4d31-9da8-b3c970e360f2 | 內容用於IMS緊急通話。 |
回應
下列MBIM_MS_PROVISIONED_CONTEXT_INFO_V2結構應用於 InformationBuffer。
| 位移 | 大小 | 欄位 | 類型 | 描述 |
|---|---|---|---|---|
| 0 | 4 | ElementCount （EC） | UINT32 | DataBuffer 中後續MBIM_MS_CONTEXT_V2結構的計數。 |
| 4 | 8 * EC | MsProvisionedContextV2RefList | OL_PAIR_LIST | 配對的第一個元素是以位元組為單位的 4 位元組位移，從這個MBIM_MS_PROVISIONED_CONTEXTS_INFO_V2結構的開頭（位移 0）到MBIM_MS_CONTEXT_V2結構（如需詳細資訊，請參閱MBIM_MS_CONTEXT_V2表格）。 配對的第二個元素是對應之MBIM_MS_CONTEXT_V2結構的指標大小為 4 位元組的大小。 |
| 4 + 8 * EC | DataBuffer | DATABUFFER | MBIM_MS_CONTEXT_V2 結構的陣列。 |
MBIM_MS_CONTEXT_V2，用於上表，提供指定內容的相關信息。
| 位移 | 大小 | 欄位 | 類型 | 描述 |
|---|---|---|---|---|
| 0 | 4 | ContextId | UINT32 | 此內容的唯一標識碼。 |
| 4 | 16 | ContextType | MBIM_CONTEXT_TYPES | 指定要表示的內容類型;例如，因特網連線、VPN（公司網路連線），或語音轉播IP（VOIP）。 裝置應該為空白或未布建的內容指定 MBIMContextTypeNone。 如需詳細資訊，請參閱MBIM_CONTEXT_TYPES數據表。 |
| 20 | 4 | IPType | MBIM_CONTEXT_IP_TYPES | 如需詳細資訊，請參閱MBIM_CONTEXT_IP_TYPES數據表。 |
| 24 | 4 | 啟用 | MBIM_MS_CONTEXT_ENABLE | 指定數據機是否可以使用內容。 如果它設定為 MbimMsContextDisabled，則任何符合內容的 OS 連線要求都應該失敗，而不會向網路發出訊號。 如需詳細資訊，請參閱MBIM_MS_CONTEXT_ENABLE數據表。 |
| 28 | 4 | 漫遊 | MBIM_MS_CONTEXT_ROAMING_CONTROL | 指定是否允許此內容漫遊。 如需詳細資訊，請參閱MBIM_MS_CONTEXT_ROAMING_CONTROL數據表。 |
| 32 | 4 | MediaType | MBIM_MS_CONTEXT_MEDIA_TYPE | 指定內容所使用的媒體傳輸類型。 如需詳細資訊，請參閱MBIM_MS_CONTEXT_MEDIA_TYPE數據表。 |
| 36 | 4 | 來源 | MBIM_MS_CONTEXT_SOURCE | 指定內容的建立來源。 如需詳細資訊，請參閱MBIM_MS_CONTEXT_SOURCE數據表。 |
| 40 | 4 | AccessStringOffset | OFFSET | 數據緩衝區中的位移至字串 AccessString，以存取網路。 針對 GSM 型網路，這會是存取點名稱 （APN） 字串，例如 「data.thephone-company.com」。。 針對 CDMA 型網路，這可能是特殊的撥號代碼，例如 “#777” 或網络存取標識碼 （NAI），例如 “foo@thephone-company.com”。 此成員可以是 NULL，要求網路指派預設 APN。 注意：並非所有網路都支援此 NULL APN 慣例，因此無效 APN 所造成的連線失敗是可能的結果。 字串的大小不應超過100個字元。 |
| 44 | 4 | AccessStringSize | SIZE（0..200） | 用於 AccessString 的大小。 |
| 48 | 4 | UserNameOffset | OFFSET | 以位元組為單位的位移，從這個結構的開頭計算到字元串UserName，代表要驗證的用戶名稱。 這個成員可以是 NULL。 |
| 52 | 4 | UserNameSize | SIZE（0..510） | 用於 UserName 的大小。 |
| 56 | 4 | PasswordOffset | OFFSET | 以位元組為單位的位移，從這個結構的開頭算起，到代表使用者名稱密碼的字串 Password。 這個成員可以是 NULL。 |
| 60 | 4 | PasswordSize | SIZE（0..510） | 用於密碼的大小。 |
| 64 | 4 | 壓縮 | MBIM_COMPRESSION | 指定要用於標頭和數據之數據連接中的壓縮。 此成員僅適用於 GSM 型裝置。 主機會將此成員設定為以CDMA為基礎的裝置的MBIMCompressionNone。 如需詳細資訊，請參閱MBIM_COMPRESSION數據表。 |
| 68 | 4 | AuthProtocol | MBIM_AUTH_PROTOCOL | 用於 PDP 啟用的驗證類型。 如需詳細資訊，請參閱MBIM_AUTH_PROTOCOL數據表。 |
| 72 | DataBuffer | DATABUFFER | 包含 AccessString、UserName 和 Password 的數據緩衝區。 |
通知
如需詳細資訊，請參閱MBIM_MS_PROVISIONED_CONTEXT_V2數據表。
狀態碼
針對查詢和設定作業：
| 狀態碼 | 描述 |
|---|---|
| MBIM_STATUS_READ_FAILURE | 作業失敗，因為裝置無法擷取布建的內容。 |
| MBIM_STATUS_NO_DEVICE_SUPPORT | 作業失敗，因為裝置不支援作業。 |
僅適用於設定作業：
| 狀態碼 | 描述 |
|---|---|
| MBIM_STATUS_INVALID_PARAMETERS | 作業因為參數無效而失敗。 |
| MBIM_STATUS_WRITE_FAILURE | 作業失敗，因為更新要求失敗。 |
使用布建內容的裝置初始化
使用布建內容初始化非 SIM 卡鎖定的 GPRS 裝置
下圖代表 GSM 型 MB 裝置的最佳用戶體驗。 現用體驗不需要任何用戶設定。 假設裝置已設定為自動選取要註冊的網路。 粗體中的標籤代表 OID 識別碼或交易流程控制。 一般文字中的標籤代表 OID 結構內的重要旗標。
若要初始化非 SIM 鎖定的 GSM 型裝置，請實作下列步驟：
MB 服務會將異步（非封鎖） OID_WWAN_READY_INFO 查詢要求傳送至迷你埠驅動程式，以識別裝置的就緒狀態。 迷你埠驅動程式會以已收到要求的暫時通知 （NDIS_STATUS_INDICATION_REQUIRED） 回應，且未來會傳送具有要求資訊的通知。
迷你埠驅動程式會將NDIS_STATUS_WWAN_READY_INFO通知傳送至 MB 服務，以向 MB 服務指出 MB 裝置的狀態為 WwanReadyStateInitialized。
MB 服務會將異步（非封鎖） OID_WWAN_REGISTER_STATE 查詢要求傳送至迷你埠驅動程式，以識別裝置的註冊狀態。 迷你埠驅動程式會以已收到要求的暫時通知 （NDIS_STATUS_INDICATION_REQUIRED） 回應，且未來會傳送具有要求資訊的通知。
迷你埠驅動程式會將NDIS_STATUS_WWAN_REGISTER_STATE通知傳送至 MB 服務，指出裝置的註冊模式為 WwanRegistraterModeAutomatic，其目前的註冊狀態為 WwanRegisterStateSearching。
稍後，當裝置向網路提供者註冊時，迷你埠驅動程式會將未經請求的NDIS_STATUS_WWAN_REGISTER_STATE通知傳送給 MB 服務，指出裝置目前的註冊狀態為 WwanRegisterStateHome。
裝置會嘗試連結封包服務。 當封包服務狀態變更為附加時，迷你埠驅動程式會將未經請求的NDIS_STATUS_WWAN_PACKET_SERVICE通知傳送給 MB 服務，指出已附加封包服務，且目前的數據類別WWAN_DATA_CLASS_GPRS。
MB 服務會將異步（非封鎖） OID_WWAN_HOME_PROVIDER 查詢要求傳送至迷你埠驅動程式，以擷取主提供者資訊。 迷你埠驅動程式會以已收到要求的臨時通知 （NDIS_STATUS_INDICATION_REQUIRED） 回應，且未來會傳送具有所要求資訊的通知。
迷你埠驅動程式會將 NDIS_STATUS_WWAN_HOME_PROVIDER 通知傳送給 MB 服務，指出家庭提供者詳細數據。
MB 服務會將異步（非封鎖）OID_WWAN_PROVISIONED_CONTEXTS查詢要求傳送至迷你埠驅動程式，以擷取已布建的內容清單。 迷你埠驅動程式會以已收到要求的暫時通知 （NDIS_STATUS_INDICATION_REQUIRED） 回應，且未來會傳送具有要求資訊的通知。
迷你埠驅動程式會將NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS通知傳送至包含WWAN_CONTEXT結構清單的 MB 服務。
MB 服務會將異步（非封鎖） OID_WWAN_CONNECT 設定要求給迷你埠驅動程式，以啟動封包數據通訊協定 （PDP） 內容。 迷你埠驅動程式會以已收到要求的暫時通知 （NDIS_STATUS_INDICATION_REQUIRED） 回應，且未來會傳送具有要求資訊的通知。
迷你埠驅動程式會將 NDIS_STATUS_WWAN_CONTEXT_STATE 通知傳送至 MB 服務，指出已啟動 PDP 內容。
迷你埠驅動程式會傳送NDIS_STATUS_LINK_STATE通知，指出媒體連線狀態為 Media 連線 State 連線 ed。
使用布建內容初始化CDMA封包裝置
下圖說明CDMA型裝置的最佳用戶體驗。 現用體驗不需要用戶設定。 此案例假設CDMA型帳戶尚未啟動。 不同於 GSM 型裝置，CDMA 型裝置會在啟用完成後自動開始向網路註冊。 粗體中的標籤是 OID 識別碼或交易流程控制。 一般文字中的標籤是 OID 結構中的重要旗標。
若要使用布建的內容初始化CDMA型封包裝置，請實作下列步驟：
MB 服務會將異步（非封鎖） OID_WWAN_READY_INFO 傳送至迷你埠驅動程式。 迷你埠驅動程式會以已收到要求的臨時通知（NDIS_STATUS_INDICATION_REQUIRED）回應，且未來會傳送具有要求資訊的通知。
迷你埠驅動程式會將NDIS_STATUS_WWAN_FAILURE傳送至 MB 服務。
MB 服務會將異步（非封鎖） OID_WWAN_SERVICE_ACTIVATION 傳送至迷你埠驅動程式。 迷你埠驅動程式會以已收到要求的臨時通知（NDIS_STATUS_INDICATION_REQUIRED）回應，且未來會傳送具有要求資訊的通知。
迷你埠驅動程式會將NDIS_STATUS_WWAN_SUCCESS傳送至 MB 服務。
迷你埠驅動程式會將NDIS_STATUS_WWAN_REGISTER_STATE傳送至 MB 服務。
迷你埠驅動程式會將NDIS_STATUS_WWAN_REGISTER_STATE傳送至 MB 服務。
迷你埠驅動程式會將NDIS_STATUS_WWAN_PACKET_SERVICE傳送至 MB 服務。
MB 服務會將異步（非封鎖） OID_WWAN_HOME_PROVIDER 傳送至迷你埠驅動程式。 迷你埠驅動程式會以已收到要求的臨時通知（NDIS_STATUS_INDICATION_REQUIRED）回應，且未來會傳送具有要求資訊的通知。
迷你埠驅動程式會將NDIS_STATUS_WWAN_SUCCESS傳送至 MB 服務。
MB 服務會將異步（非封鎖） OID_WWAN_PROVISIONED_CONTEXTS 傳送至迷你埠驅動程式。 迷你埠驅動程式會以已收到要求的臨時通知 （NDIS_STATUS_INDICATION_REQUIRED） 回應，且未來會傳送具有所要求資訊的通知。
迷你埠驅動程式會將NDIS_STATUS_WWAN_SUCCESS傳送至 MB 服務。
MB 服務會將異步（非封鎖） OID_WWAN_PROVISIONED_CONTEXTS 傳送至迷你埠驅動程式。 迷你埠驅動程式會以已收到要求的暫時通知 （NDIS_STATUS_INDICATION_REQUIRED） 回應，且未來會傳送具有要求資訊的通知。
迷你埠驅動程式會將NDIS_STATUS_WWAN_SUCCESS傳送至 MB 服務。
迷你埠驅動程式會將NDIS_STATUS_LINK_STATE傳送至 MB 服務。