MB 低階 UICC 存取
概觀
行動寬頻介面模型修訂 1.0 或 MBIM1 會定義主機裝置與行動資料數據機之間的 OEM 和 IHV 無關介面。
MBIM1 函式包含 UICC 智慧卡,並提供部分資料和內部狀態的存取權。 不過,智慧卡可能會有 MBIM 介面所定義以外的其他功能。 這些額外功能包括支援以近距離通訊為基礎的行動付款解決方案安全元素,或針對整個 UICC 設定檔的遠端布建。
在啟用行動寬頻的 Windows 裝置中,除了單選介面層 (RIL) 介面之外,還會使用 MBIM 介面。 RIL 提供的其中一項功能是 UICC 低階存取的介面。 本主題描述 MBIM 的一組 Microsoft 擴充功能,描述 MBIM 介面上的這項額外功能。
Microsoft 擴充功能包含一組裝置服務命令, (設定和查詢) 和通知。 這些擴充功能不包含裝置服務資料流程的任何新用途。
MBIM 服務和 CID 值
服務名稱 | UUID | UUID 值 |
---|---|---|
Microsoft Low-Level UICC 存取 | UUID_MS_UICC_LOW_LEVEL | C2F6588E-F037-4BC9-8665-F4D44BD09367 |
下表指定每個 CID 的命令程式碼,以及 CID 是否支援 Set、Query 或 Event (通知) 要求。 如需其參數、資料結構和通知的詳細資訊,請參閱本主題中的每個 CID 個別章節。
CID | 命令程式碼 | 集合 | 查詢 | Notify |
---|---|---|---|---|
MBIM_CID_MS_UICC_ATR | 1 | N | Y | N |
MBIM_CID_MS_UICC_OPEN_CHANNEL | 2 | Y | N | N |
MBIM_CID_MS_UICC_CLOSE_CHANNEL | 3 | Y | N | N |
MBIM_CID_MS_UICC_APDU) | 4 | Y | N | N |
MBIM_CID_MS_UICC_TERMINAL_CAPABILITY | 5 | Y | Y | N |
MBIM_CID_MS_UICC_RESET | 6 | Y | Y | N |
狀態碼
MBIM 狀態碼定義于 MBIM 標準的第 9.4.5 節中。 此外,還會定義下列額外的失敗狀態碼:
狀態碼 | 值 (十六進位) | 描述 |
---|---|---|
MBIM_STATUS_MS_NO_LOGICAL_CHANNELS | 87430001 | 未成功開啟邏輯通道,因為 UICC 上沒有可用的邏輯通道, (不支援邏輯通道,或所有通道都正在使用) 。 |
MBIM_STATUS_MS_SELECT_FAILED | 87430002 | 邏輯通道開啟失敗,因為 SELECT 失敗。 |
MBIM_STATUS_MS_INVALID_LOGICAL_CHANNEL | 87430003 | MBIM_CID_MS_UICC_OPEN_CHANNEL) 未開啟邏輯通道號碼 (無效。 |
MBIM_SUBSCRIBER_READY_STATE
類型 | 值 | 描述 |
---|---|---|
MBIMSubscriberReadyStateNoEsimProfile | 7 | 卡片已就緒,但沒有任何已啟用的設定檔。 |
UICC 回應和狀態
UICC 可以實作字元型或記錄型介面,或同時實作兩者。 雖然特定機制不同,但結果是 UICC 會以兩個狀態位元組回應每個命令, (名為 SW1 和 SW2) ,以及回應 (可能是空的) 。 正常成功狀態會以 90 00 表示。 不過,如果 UICC 支援卡片應用程式工具組,而 UICC 想要將主動式命令傳送至終端機,則成功傳回的狀態會以 XX (的狀態表示,其中 XX 會有所不同) 。 MBIM 函式或終端機負責處理此主動式命令,就像處理任何其他 UICC 作業期間收到的主動式命令一樣, (將 FETCH 傳送至 UICC、處理主動式命令,或傳送至具有MBIM_CID_STK_PAC) 的主機。 當 MBIM 主機傳送MBIM_CID_MS_UICC_OPEN_CHANNEL或MBIM_CID_MS_UICC_APDU時,應該將 90 00 和 91 XX 視為正常狀態。
命令必須能夠傳回大於 256 個位元組的回應。 這項機制會在 ISO/IEC 7816-4:2013 標準的第 5.1.3 節中說明。 在此情況下,卡片會傳回 SW1 SW1 SW2 狀態文字 61 XX,而不是 90 00,其中 XX 是剩餘位元組的數目,如果剩餘的位元組數為 256 個或更多位元組,則傳回 00。 數據機必須重複發出具有相同類別位元組的 GET RESPONSE,直到收到所有資料為止。 這會以最終狀態文字 90 00 表示。 序列必須在特定邏輯通道內不中斷。 其他 APTU 應該在數據機上處理,而且應該對主機而言是透明的。 如果已在主機中處理,則不保證某些其他 APDU 可能會在 APDU 序列期間以非同步方式參考卡片。
IHVRIL 的比較
IHVRIL 規格的 5.2.3.3.10 到 5.2.3.3.14 節會定義此規格所依據的類似介面。 一些差異包括:
- RIL 介面不提供指定安全傳訊的方式。 用來交換 APTU 的 MBIM 命令會將這個 指定為明確的參數。
- RIL 介面不會清楚定義 APDU 內類別位元組的解譯。 MBIM 規格指出從主機傳送的類別位元組必須存在,但不會 (使用,而是 MBIM 函式會建構此位元組) 。
- RIL 介面會使用個別的函式來關閉群組中的所有 UICC 通道,而 MBIM 介面則會使用單一 CID 的 variant 引數來完成此作業。
- MBIM 錯誤狀態與 UICC 狀態 (SW1 SW2) 之間的關聯性,比 RIL 錯誤與 UICC 狀態之間的關聯性更清楚。
- MBIM 介面會區分無法配置新邏輯通道給 SELECT 指定應用程式的失敗。
- MBIM 介面允許傳送數據機終端機功能物件以傳送至卡片。
MBIM_CID_MS_UICC_ATR
重設 (ATR) 是執行重設之後 UICC 所傳送的第一個位元組字串。 它會描述卡片的功能,例如它支援的邏輯通道數目。 MBIM 函式必須在從 UICC 收到 ATR 時儲存。 接著,主機可以使用 MBIM_CID_MS_UICC_ATR 命令來擷取 ATR。
參數
類型 | 集合 | 查詢 | 通知 |
---|---|---|---|
命令 | 不適用 | 空白 | 不適用 |
回應 | 不適用 | MBIM_MS_ATR_INFO | 不適用 |
查詢
查詢訊息的 InformationBuffer 是空的。
集合
不適用。
回應
MBIM_COMMAND_DONE的 InformationBuffer 包含下列MBIM_MS_ATR_INFO結構,描述要針對附加至此函式之 UICC 重設的答案。
MBIM_MS_ATR_INFO
Offset | 大小 | 欄位 | 類型 | 描述 |
---|---|---|---|---|
0 | 4 | AtrSize | SIZE (0..33) | AtrData的長度。 |
4 | 4 | AtrOffset | OFFSET | 以位元組為單位的位移,從這個 結構的開頭計算到名為 AtrData 的位元組陣列,其中包含 ATR 資料。 |
8 | AtrSize | DataBuffer | DATABUFFER | AtrData位元組陣列。 |
未經請求的事件
不適用。
狀態碼
下列狀態碼適用。
狀態碼 | 描述 |
---|---|
MBIM_STATUS_SUCCESS | 針對所有命令定義的基本 MBIM 狀態。 |
MBIM_STATUS_BUSY | 針對所有命令定義的基本 MBIM 狀態。 |
MBIM_STATUS_FAILURE | 針對所有命令定義的基本 MBIM 狀態。 |
MBIM_STATUS_NO_DEVICE_SUPPORT | 針對所有命令定義的基本 MBIM 狀態。 |
MBIM_STATUS_SIM_NOT_INSERTED | 無法執行 UICC 作業,因為缺少 UICC。 |
MBIM_STATUS_BAD_SIM | 無法執行 UICC 作業,因為 UICC 處於錯誤狀態。 |
MBIM_STATUS_NOT_INITIALIZED | 無法執行 UICC 作業,因為尚未完全初始化 UICC。 |
MBIM_CID_MS_UICC_OPEN_CHANNEL
主機會使用 MBIM_CID_MS_UICC_OPEN_CHANNEL 命令來要求函式在 UICC 卡上開啟新的邏輯通道,然後選取應用程式識別碼所指定的指定 UICC 應用程式 () 。
函式會使用一連串的 UICC 命令來實作此 MBIM 命令:
- 函式會將 MANAGE CHANNEL 命令傳送至 UICC,如 ETSI TS 102 221 技術規格的第 11.1.17 節所述,以建立新的邏輯通道。 如果此命令失敗,函式會傳回 SW1 SW2 的MBIM_STATUS_MS_NO_LOGICAL_CHANNELS狀態,且不會採取進一步的動作。
- 如果 MANAGE CHANNEL 命令成功,UICC 會將新邏輯通道的通道號碼回報給函式。 函式會傳送 SELECT [by name] 命令,其中 P1 = 04,如 ETSI TS 102 221 技術規格的第 11.1.1 節所述。 如果這項作業失敗,函式會將 MANAGE CHANNEL 命令傳送至 UICC 以關閉邏輯通道,並從 SELECT 傳回 SW1 SW2 的MBIM_STATUS_MS_SELECT_FAILED狀態。
- 如果 SELECT 命令成功,函式會記錄主機指定的邏輯通道號碼和通道群組,以供日後參考。 然後,它會從 SELECT 傳回邏輯通道號碼 SW1 SW2,以及從 SELECT 到主機的回應。
參數
作業 | 集合 | 查詢 | 通知 |
---|---|---|---|
命令 | MBIM_MS_SET_UICC_OPEN_CHANNEL | 不適用 | 不適用 |
回應 | MBIM_MS_UICC_OPEN_CHANNEL_INFO | 不適用 | 不適用 |
查詢
不適用。
集合
MBIM_COMMAND_MSG的 InformationBuffer 包含下列MBIM_MS_SET_UICC_OPEN_CHANNEL結構。
MBIM_MS_SET_UICC_OPEN_CHANNEL
Offset | 大小 | 欄位 | 類型 | 描述 |
---|---|---|---|---|
0 | 4 | AppIdSize | SIZE (0..32) | 應用程式識別碼的大小 (AppId) 。 |
4 | 4 | AppIdOffset | OFFSET | 以位元組為單位的位移,從這個結構的開頭計算到名為 AppId 的位元組陣列,此陣列會定義要設定為 SELECTed 的 AppId 。 |
8 | 4 | SelectP2Arg | UINT32 (0..255) | SELECT 命令的 P2 引數。 |
12 | 4 | ChannelGroup | UINT32 | 標記值,識別此通道的通道群組。 |
16 | AppIdSize | DataBuffer | DATABUFFER | AppId位元組陣列。 |
回應
MBIM_COMMAND_DONE的 InformationBuffer 包含下列MBIM_MS_UICC_OPEN_CHANNEL_INFO結構。
MBIM_MS_UICC_OPEN_CHANNEL_INFO
Offset | 大小 | 欄位 | 類型 | 描述 |
---|---|---|---|---|
0 | 4 | 狀態 | BYTE[2] | SW1 和 SW2,以該位元組順序排列。 如需詳細資訊,請參閱下表後面的附注。 |
4 | 4 | 通路 | UINT32 (0..19) | 邏輯通道識別碼。 如果此成員為 0,則作業失敗。 |
8 | 4 | ResponseLength | SIZE (0..256) | 以位元組為單位的回應長度。 |
12 | 4 | ResponseOffset | OFFSET | 以位元組為單位的位移,從這個結構的開頭計算到名為 Response 的位元組陣列,其中包含 SELECT 的回應。 |
16 | - | DataBuffer | DATABUFFER | 回應位元組陣列資料。 |
如果命令傳回MBIM_STATUS_MS_NO_LOGICAL_CHANNELS, [狀態 ] 欄位應包含 [管理通道] 命令中的 UICC 狀態字 SW1 和 SW2,其餘欄位會是零。 如果命令傳回MBIM_STATUS_MS_SELECT_FAILED, [狀態 ] 欄位應包含 SELECT 命令中的 UICC 狀態字 SW1 和 SW2,其餘欄位將會是零。 對於任何其他狀態,InformationBuffer 應為空白。
未經請求的事件
不適用。
狀態碼
下列狀態碼適用:
狀態碼 | 描述 |
---|---|
MBIM_STATUS_SUCCESS | 針對所有命令所定義的基本 MBIM 狀態。 |
MBIM_STATUS_BUSY | 針對所有命令所定義的基本 MBIM 狀態。 |
MBIM_STATUS_FAILURE | 針對所有命令所定義的基本 MBIM 狀態。 |
MBIM_STATUS_NO_DEVICE_SUPPORT | 針對所有命令所定義的基本 MBIM 狀態。 |
MBIM_STATUS_SIM_NOT_INSERTED | 無法執行 UICC 作業,因為 UICC 遺失。 |
MBIM_STATUS_BAD_SIM | 無法執行 UICC 作業,因為 UICC 處於錯誤狀態。 |
MBIM_STATUS_NOT_INITIALIZED | 無法執行 UICC 作業,因為 UICC 尚未完全初始化。 |
MBIM_STATUS_MS_NO_LOGICAL_CHANNELS | 開啟邏輯通道失敗,因為 UICC 上沒有可用的邏輯通道, (不支援邏輯通道,或是所有通道都正在使用) 。 |
MBIM_STATUS_MS_SELECT_FAILED | 邏輯通道開啟失敗,因為 SELECT 失敗。 |
MBIM_CID_MS_UICC_CLOSE_CHANNEL
主機會將MBIM_CID_MS_UICC_CLOSE_CHANNEL傳送至 函式,以關閉 UICC 上的邏輯通道。 主機可以指定通道號碼,也可以指定通道群組。
如果主機指定通道號碼,函式應該檢查先前的MBIM_CID_MS_UICC_OPEN_CHANNEL是否開啟此通道。 如果是,它應該將 MANAGE CHANNEL 命令傳送至 UICC 以關閉通道、傳回MBIM_STATUS_SUCCESS的狀態,然後從 MANAGE 通道傳回 SW1 SW2。 如果沒有,它應該不會採取任何動作,並傳回MBIM_STATUS_MS_INVALID_LOGICAL_CHANNEL失敗狀態。
如果主機指定通道群組,則函式 (會判斷是否已使用該通道群組開啟任何) 邏輯通道,並將 MANAGE CHANNEL 命令傳送至每個這類通道的 UICC。 它會傳回MBIM_STATUS_SUCCESS狀態,其中包含最後一個管理通道的 SW1 SW2。 如果沒有關閉通道,它應該會傳回 90 00。
參數
作業 | 集合 | 查詢 | 通知 |
---|---|---|---|
命令 | MBIM_MS_SET_UICC_CLOSE_CHANNEL | 不適用 | 不適用 |
回應 | MBIM_MS_UICC_CLOSE_CHANNEL_INFO | 不適用 | 不適用 |
查詢
不適用。
集合
MBIM_COMMAND_MSG的 InformationBuffer 包含下列MBIM_MS_SET_UICC_CLOSE_CHANNEL結構。
MBIM_MS_SET_UICC_CLOSE_CHANNEL
Offset | 大小 | 欄位 | 類型 | 描述 |
---|---|---|---|---|
0 | 4 | 通路 | UINT32 (0..19) | 如果為非零,則指定要關閉的通道。 如果為零,則指定通道 (與 ChannelGroup 相關聯的) 關閉。 |
4 | 4 | ChannelGroup | UINT32 | 如果 Channel 為零,這會指定標籤值,並關閉具有此標籤的所有通道。 如果 Channel 為非零,則會忽略此欄位。 |
回應
MBIM_COMMAND_DONE的 InformationBuffer 包含下列MBIM_MS_UICC_CLOSE_CHANNEL_INFO結構。
MBIM_MS_UICC_CLOSE_CHANNEL_INFO
Offset | 大小 | 欄位 | 類型 | 描述 |
---|---|---|---|---|
0 | 4 | 狀態 | BYTE[2] | 由函式代表此命令執行的最後一個 MANAGE 通道 SW1 和 SW2。 |
未經請求的事件
不適用。
狀態碼
狀態碼 | 描述 |
---|---|
MBIM_STATUS_SUCCESS | 針對所有命令定義的基本 MBIM 狀態。 |
MBIM_STATUS_BUSY | 針對所有命令定義的基本 MBIM 狀態。 |
MBIM_STATUS_FAILURE | 針對所有命令定義的基本 MBIM 狀態。 |
MBIM_STATUS_NO_DEVICE_SUPPORT | 針對所有命令定義的基本 MBIM 狀態。 |
MBIM_STATUS_SIM_NOT_INSERTED | 無法執行 UICC 作業,因為缺少 UICC。 |
MBIM_STATUS_BAD_SIM | 無法執行 UICC 作業,因為 UICC 處於錯誤狀態。 |
MBIM_STATUS_NOT_INITIALIZED | 無法執行 UICC 作業,因為尚未完全初始化 UICC。 |
MBIM_STATUS_MS_INVALID_LOGICAL_CHANNEL | 邏輯通道號碼無效, (換句話說,它未以MBIM_CID_MS_UICC_OPEN_CHANNEL) 開啟。 |
MBIM_CID_MS_UICC_APDU
主機會使用 MBIM_CID_MS_UICC_APDU 將命令 APDU 傳送至 UICC 上的指定邏輯通道,並接收回應。 MBIM 函式應該確保邏輯通道先前是以 MBIM_CID_MS_UICC_OPEN_CHANNEL 開啟,如果不是,則會失敗並顯示狀態MBIM_STATUS_MS_INVALID_LOGICAL_CHANNEL。
主機必須將完整的 APDU 傳送至 函式。 APDU 可能會以 ISO /IEC 7816-4:2013 標準第 4 節中定義的類別位元組值傳送,或在 ETSI TS 10.1.1 第 10.1.1節的擴充定義中傳送。 不需要安全傳訊或具有安全傳訊,就可以傳送 APDU。 命令標頭未通過驗證。 主機會指定類別位元組的類型、邏輯通道號碼,以及 APDU 的安全傳訊。
命令 APDU 的第一個位元組是由 ISO/IEC 7816-4:2013 標準 第 4 節或 ETSI TS 102 221 技術規格的第 10.1.1 節所定義的類別位元組。 主機可能會傳送 0X、4X、6X、8X、CX 或 EX 類別位元組。 不過,函式不會將此位元組直接傳遞至 UICC。 相反地,在將 APDU 傳送至 UICC 之前,函式會將主機中的第一個位元組取代為新的類別位元組, (編碼為 ISO /IEC 7816-4:2013 標準 的第 4 節或 ETSI TS 102 221 技術規格的第 10.1.1 節,) 型別為基礎, 主機指定的通道和 SecureMessaging 值:
Byte 類別 | 描述 |
---|---|
0X | 7816-4 interindustry, 1 < = channel < = 3,如果相關,則編碼低 Nibble 的安全性 |
4X | 7816-4 interindustry, 4 < = channel < = 19, no secure messaging |
6X | 7816-4 interindustry, 4 < = channel < = 19, secure (header not authenticated) |
8X | 102 221 擴充,1 < = 通道 < = 3,如果相關,則以低 Nibble 編碼安全性 |
CX | 102 221 擴充,4 < = 通道 < = 19,無安全傳訊 |
EX | 102 221 擴充,4 < = 通道 < = 19,安全 (標頭未驗證) |
函式應該會傳回狀態、SW1 SW2,以及從 UICC 到主機的回應。
參數
作業 | 集合 | 查詢 | 通知 |
---|---|---|---|
命令 | MBIM_MS_SET_UICC_APDU | 不適用 | 不適用 |
回應 | MBIM_MS_UICC_APDU_INFO | 不適用 | 不適用 |
查詢
不適用。
集合
MBIM_COMMAND_MSG的 InformationBuffer 包含下列MBIM_MS_SET_UICC_APDU結構。
MBIM_MS_SET_UICC_APDU
Offset | 大小 | 欄位 | 類型 | 描述 |
---|---|---|---|---|
0 | 4 | 通路 | UINT32 (1..19) | 指定要傳送 APDU 的通道。 |
4 | 4 | SecureMessaging | MBIM_MS_UICC_SECURE_MESSAGING | 指定是否使用安全傳訊交換 APDU。 |
8 | 4 | 類型 | MBIM_MS_UICC_CLASS_BYTE_TYPE | 指定類別位元組定義的類型。 |
12 | 4 | CommandSize | UINT32 (0..261) | 以位元組為單位的 命令 長度。 |
16 | 4 | CommandOffset | OFFSET | 以位元組為單位的位移,從這個結構的開頭計算到名為 Command 的位元組陣列,其中包含 APDU。 |
20 | - | DataBuffer | DATABUFFER | Command byte 陣列。 |
MBIM_MS_SET_UICC_APDU 結構會使用下列MBIM_MS_UICC_SECURE_MESSAGING和MBIM_MS_UICC_CLASS_BYTE_TYPE資料結構。
MBIM_MS_UICC_SECURE_MESSAGING
類型 | 值 | 描述 |
---|---|---|
MBIMMsUiccSecureMessagingNone | 0 | 沒有安全傳訊。 |
MBIMMsUiccSecureMessagingNoHdrAuth | 1 | 安全傳訊,命令標頭未通過驗證。 |
MBIM_MS_UICC_CLASS_BYTE_TYPE
類型 | 值 | 描述 |
---|---|---|
MBIMMsUiccInterindustry | 0 | 根據 ISO 7816-4 中的第一個間定義定義。 |
MBIMMsUiccExtended | 1 | 根據 ETSI 102 221 中的擴充定義來定義。 |
回應
MBIM_COMMAND_DONE的 InformationBuffer 包含下列MBIM_MS_UICC_APDU_INFO結構。
MBIM_MS_UICC_APDU_INFO
Offset | 大小 | 欄位 | 類型 | 描述 |
---|---|---|---|---|
0 | 4 | 狀態 | BYTE[2] | 由 命令產生的 SW1 和 SW2 狀態字組。 |
4 | 4 | ResponseLength | SIZE | 以位元組為單位的回應長度。 |
8 | 4 | ResponseOffset | OFFSET | 以位元組為單位的位移,從這個結構的開頭計算到名為 Response 的位元組陣列,其中包含 SELECT 的回應。 |
12 | - | DataBuffer | DATABUFFER | 回應位元組陣列。 |
未經請求的事件
不適用。
狀態碼
下列狀態碼適用:
狀態碼 | 描述 |
---|---|
MBIM_STATUS_SUCCESS | 針對所有命令定義的基本 MBIM 狀態。 |
MBIM_STATUS_BUSY | 針對所有命令定義的基本 MBIM 狀態。 |
MBIM_STATUS_FAILURE | 針對所有命令定義的基本 MBIM 狀態。 |
MBIM_STATUS_NO_DEVICE_SUPPORT | 針對所有命令定義的基本 MBIM 狀態。 |
MBIM_STATUS_SIM_NOT_INSERTED | 無法執行 UICC 作業,因為缺少 UICC。 |
MBIM_STATUS_BAD_SIM | 無法執行 UICC 作業,因為 UICC 處於錯誤狀態。 |
MBIM_STATUS_NOT_INITIALIZED | 無法執行 UICC 作業,因為尚未完全初始化 UICC。 |
MBIM_STATUS_MS_INVALID_LOGICAL_CHANNEL | 邏輯通道號碼無效, (換句話說,它未以MBIM_CID_MS_UICC_OPEN_CHANNEL) 開啟。 |
如果函式可以將 APDU 傳送至 UICC,它會傳回MBIM_STATUS_SUCCESS以及 SW1 SW2 狀態字組,以及來自 UICC 的回應 (,如果有任何) ,則傳回來自 UICC 的回應。 主機必須檢查 SW1 SW2) 的狀態 (,以判斷 APIDU 命令在 UICC 上是否成功或失敗的原因。
MBIM_CID_MS_UICC_TERMINAL_CAPABILITY
主機會傳送MBIM_CID_MS_UICC_TERMINAL_CAPABILITY,通知數據機主機的功能。 在 ETSI TS 102 221 技術規格的第 11.1.19 節中指定的 TERMINAL CAPABILITY APDU,必須先傳送至卡片,才能選取第一個應用程式, (如果支援) 。 因此,主機無法直接傳送 TERMINAL CAPABILITY APDU,而是傳送包含一或多個終端機功能物件的 MBIM_CID_MS_UICC_TERMINAL_CAPABILITY命令,這些物件會由數據機持續儲存。 在下一張卡片插入或重設 ATR 之後,數據機會選取 MF,並檢查是否支援終端功能。 如果是的話,數據機會傳送 TERMINAL CAPABILITY APDU,其中包含 MBIM_CID_MS_UICC_TERMINAL_CAPABILITY 命令所指定的資訊,以及任何數據機產生的資訊。
參數
作業 | 集合 | 查詢 | 通知 |
---|---|---|---|
命令 | MBIM_MS_SET_UICC_TERMINAL_CAPABILITY | 空白 | 不適用 |
回應 | 不適用 | MBIM_MS_TERMINAL_CAPABILITY_INFO | 不適用 |
查詢
InformationBuffer 應為 Null,且 InformationBufferLength 應為零。
集合
MBIM_COMMAND_MSG的 InformationBuffer 包含下列MBIM_MS_SET_UICC_TERMINAL_CAPABILITY結構。
MBIM_MS_SET_UICC_TERMINAL_CAPABILITY
Offset | 大小 | 欄位 | 類型 | 描述 |
---|---|---|---|---|
0 | 4 | ElementCount | UINT32 | 終端功能物件的專案計數。 |
4 | 8*EC | CapabilityList OL_PAIR_LIST | 每個終端機功能物件 TLV 的位移長度配對清單。 | |
4+8*EC | - | DataBuffer | DATABUFFER | 實際終端機功能物件 TVS 的位元組陣列。 |
回應
回應會包含確切的 SET 命令,其中包含最後傳送至數據機的終端機功能物件。 因此,MBIM_MS_TERMINAL_CAPABILITY_INFO與MBIM_MS_SET_UICC_TERMINAL_CAPABILITY相同。
MBIM_MS_TERMINAL_CAPABILITY_INFO
Offset | 大小 | 欄位 | 類型 | 描述 |
---|---|---|---|---|
0 | 4 | ElementCount | UINT32 | 終端功能物件的專案計數。 |
4 | 8*EC | CapabilityList OL_PAIR_LIST | 每個終端機功能物件 TLV 的位移長度配對清單。 | |
4+8*EC | - | DataBuffer | DATABUFFER | 實際終端機功能物件 TVS 的位元組陣列。 |
未經請求的事件
不適用。
狀態碼
狀態碼 | 描述 |
---|---|
MBIM_STATUS_SUCCESS | 針對所有命令定義的基本 MBIM 狀態。 |
MBIM_STATUS_BUSY | 針對所有命令定義的基本 MBIM 狀態。 |
MBIM_STATUS_FAILURE | 針對所有命令定義的基本 MBIM 狀態。 |
MBIM_STATUS_NO_DEVICE_SUPPORT | 針對所有命令定義的基本 MBIM 狀態。 |
MBIM_STATUS_SIM_NOT_INSERTED | 無法執行 UICC 作業,因為缺少 UICC。 |
MBIM_STATUS_BAD_SIM | 無法執行 UICC 作業,因為 UICC 處於錯誤狀態。 |
MBIM_STATUS_NOT_INITIALIZED | 無法執行 UICC 作業,因為尚未完全初始化 UICC。 |
MBIM_STATUS_MS_INVALID_LOGICAL_CHANNEL | 邏輯通道號碼無效, (換句話說,它未以MBIM_CID_MS_UICC_OPEN_CHANNEL) 開啟。 |
MBIM_CID_MS_UICC_RESET
主機會將MBIM_CID_MS_UICC_RESET傳送至 MBIM 函式,以重設 UICC 或查詢函式的傳遞狀態。
當主機要求函式重設 UICC 時,它會指定傳遞動作。
如果主機指定 MBIMMSUICCPassThroughEnable 傳遞動作,即使 UICC 沒有電信 UICC 檔案系統) ,函式也會重設 UICC,並在 UICC 電源啟動時將 UICC 視為處於傳遞模式,以啟用主機與 UICC (之間的通訊。 函式不會將任何 APTU 傳送至卡片,而且不會隨時干擾主機與 UICC 之間的通訊。
如果主機指定 MBIMMSUICCPassThroughDisable 傳遞動作,此函式會重設 UICC,並在 UICC 電源啟動時將 UICC 視為一般電信 UICC,並預期 UICC 檔案系統出現在 UICC 上。
當主機查詢函式以判斷傳遞狀態時,如果函式以 MBIMMsUICCPassThroughEnabled 狀態回應,表示已啟用傳遞模式。 如果函式以 MBIMMsUICCPassThroughDisabled 狀態回應,表示傳遞模式已停用。
參數
類型 | 集合 | 查詢 | 通知 |
---|---|---|---|
命令 | MBIM_MS_SET_UICC_RESET | 空白 | 不適用 |
回應 | MBIM_MS_UICC_RESET_INFO | MBIM_MS_UICC_RESET_INFO | 不適用 |
查詢
InformationBuffer 應為 Null, 且 InformationBufferLength 應為零。
集合
MBIM_SET_MS_UICC_RESET
MBIM_SET_MS_UICC_RESET 結構包含主機指定的傳遞動作。
Offset | 大小 | 欄位 | 類型 | 描述 |
---|---|---|---|---|
0 | 4 | PassThroughAction | MBIM_MS_UICC_PASSTHROUGH_ACTION | 如需詳細資訊,請參閱 MBIM_MS_UICC_PASSTHROUGH_ACTION。 |
MBIM_MS_UICC_PASSTHROUGH_ACTION
MBIM_MS_UICC_PASSTHROUGH_ACTION列舉定義主機可以指定給 MBIM 函式的傳遞動作類型。
類型 | 值 |
---|---|
MBIMMsUiccPassThroughDisable | 0 |
MBIMMsUiccPassThroughEnable | 1 |
回應
MBIM_MS_UICC_RESET_INFO
MBIM_MS_UICC_RESET_INFO 結構包含 MBIM 函式的傳遞狀態。
Offset | 大小 | 欄位 | 類型 | 描述 |
---|---|---|---|---|
0 | 4 | PassThroughStatus | MBIM_MS_UICC_PASSTHROUGH_STATUS | 如需詳細資訊,請參閱 MBIM_MS_UICC_PASSTHROUGH_STATUS。 |
MBIM_MS_UICC_PASSTHROUGH_STATUS
MBIM_MS_UICC_PASSTHROUGH_STATUS列舉會定義 MBIM 函式指定給主機的傳遞狀態類型。
類型 | 值 |
---|---|
MBIMMsUiccPassThroughDisabled | 0 |
MBIMMsUiccPassThroughEnabled | 1 |
未經請求的事件
不適用。
狀態碼
狀態碼 | 描述 |
---|---|
MBIM_STATUS_SUCCESS | 針對所有命令定義的基本 MBIM 狀態。 |
MBIM_STATUS_BUSY | 裝置忙碌中。 |
MBIM_STATUS_FAILURE | 作業失敗。 |
MBIM_STATUS_NO_DEVICE_SUPPORT | 裝置不支援這項作業。 |
OID_WWAN_UICC_RESET
MBIM_CID_MS_UICC_RESET的 NDIS 對等專案是 OID_WWAN_UICC_RESET。